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Preface 





Before using this handbook, you should have a basic understanding of DNOS operations, directory 
structures, and pathnames. If you need detailed information about specific items, refer to the 
manual or manuals suggested in each section. 

This handbook contains the following sections: 


Section 


1 General Operations — Describes log-on and log-off procedures and useful command 
sequences and procedures. 


2 Using SCI — Lists SCI function keys and SCI primitives. 


3 Assembly Language Instructions and Formats — Gives assembly language instructions 
and formats and the object code format. 
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Appendix 


A 


Program Development — Provides information on how to set up and execute a program 
and lists link editor commands and debugger commands. 


SVC Blocks — Presents the structure of each SVC block and lists the type of 
information you must provide for each. 


ASCII Character Codes — Lists ASCII characters and their equivalent hexadecimal 
codes. 


Job and Task States — Lists job and task state codes. 


Keycap Cross-Reference — Lists the generic key names and shows the corresponding 
keycap labels on each terminal supported by DNOS. Throughout this handbook, keys are 
referred to by generic name. 
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; General Operations 


1.1 INTRODUCTION 


This section describes general operations, logging on, logging off, and useful command 
sequences and procedures. 


1.2 GENERIC KEY NAMES 


The names used in this handbook for individual keys on terminals are generic key names and apply 
to all terminals. In some cases the names on the keycaps of some terminals match the generic 
names, but in many cases they do not. Table A-1 in Appendix A includes the generic key names 
and the corresponding keys for each terminal supported by DNOS. Appendix A also contains a 
reverse reference table showing commonly used keys on the Model 911 VDT and the correspond- 
ing generic key names. | 
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1.3 LOGGING ON 
Before you can use DNOS at a terminal, you must activate the System Command Interpreter (SCI). 
Since you can customize activation procedures to a particular application, the prompts shown in 
this paragraph do not appear in every case. These steps show the procedure for activating SCI ata 
terminal: 

1. Turnonthe terminal if it is not already on. 

2. Press the Attention key. 


3. Enterthe exclamation mark (!). 


4. If this is the first terminal to log on after loading DNOS, enter the year, month, day, hour, 
and minute as requested. 
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5. DNOS responds by displaying or printing the following message: 
DNOS 1.X.XX 
where: 
1.X.XX is the release version of DNOS. 

6. If user identification is required, DNOS displays the following prompts: 


USER ID: 
PASSCODE: 


Type in your assigned user ID and press the Return key to signal DNOS that an entry has 
been made. The user ID must be all uppercase characters. Next, type in your assigned 
passcode and press the Return key to signal DNOS that another entry has been made. 
To preserve passcode security, the characters of the passcode are not displayed. 


7. DNOS may respond by displaying the following prompt (if it is not predefined by the 
Modify Terminal Status (MTS) command). 


ACCOUNT ID: 
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Type in the assigned account ID and press the Return key to signal that an entry has 
been made. Your account ID must be avalid number found in the file SSACCVAL. 


8. DNOS may respond by displaying the following prompt (if it is not predefined by the MTS 
command): 


JOB NAME: 


Type in a job name and press the Return key to signal DNOS that an entry has been 
made. A job name can be any alphanumeric string (maximum of eight characters) that 
starts with an alphabetic character or a dollar sign ($) and consists of only uppercase 
characters. 


9. DNOS may respond by displaying the following prompt (if it is set for display by the MTS 
command): 


SYNONYM FILE PATHNAME: 
Enter the pathname of the file that contains the synonyms and logical names you want 
to use, or press the Return key to accept the default pathname (the file in which the syn- 


onyms for your user ID are normally kept). If a file is supplied, it must have been origi- 
nally established by the Snapshot Name Definitions (SND) command. 
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10. 


V1; 
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If the job name entered is already in use with the same user ID, DNOS may respond with 
the following prompt: 


RECONNECT?: 


Type in YES or NO and press the Return key to signal that an entry has been made. YES 
specifies that the terminal is also to be associated with the job in use. NO specifies that 
the terminal is to be associated with a new job. An ACCOUNT ID validation is not per- 
formed when YES is specified. 


If the log-on is successful, DNOS either displays the main menu and the SCI prompt ({ ]) 
or it displays the news file if one exists. If a news file is displayed, SCI waits for the 
Command key to be pressed. After the Command key is pressed, SCI displays the main 
menu and SCI prompt ([ ]) as shown in Figure 1-1. The main menu can be changed at the 
option of the systems programmer. 
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Command Groups: 


/DEBUG 
/DEVICE 
/DIR 
/EDIT 
/FILE 
/JOB 
/LANG 
/LUNO 
/MSG 
/NAME 
/NET 
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- Interactive Debugger 
- I/0 Devices 

- Directories 

- Text Editor 

- File Management 

- Job Management 

- Language Support 

- Logical Unit Numbers 
- Message Facilities 


- Synonyms and Logical Names 


- Networking Support 


Figure 1-1. 


/OPER 
/PREXEC 
/PRFILE 
/SECURE 
/SPOOL 
/STATUS 
/SYSCON 
/SYSGEN 
/SYSMGT 
/TPD 
/VOLUME 


SCI Main Menu 


1-6 


Operator Interface 
Program Execution 
Program Files 

File Security 
Spooler 

Status Reports 
System Configuration 
System Generation 
system Management 
Teleprinter Devices 
Disk Volumes 
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12. 


13. 


To begin operating the terminal, enter the SCI commands that are available to you. If you 
enter a command that is not authorized for your user ID, SCI will display an appropriate 
error message. 


While executing SCI commands, do not turn off the terminal. If the terminal is turned off, 
device errors are written to the system log and the system may loop in an attempt to 
complete the command. 


1.4 LOGGING OFF 


Follow these steps to log off. 


1. 


2. 


Enter the Quit (Q) command. 


If the text editor or debugger is active at the terminal, the Q command automatically 
prompts for the Quit Editor (QE) or Quit Debug (QD) command responses. If not, SCI 
terminates at this point. 


After you enter the necessary responses to either the QE or QD command, enter the Q 
command again to terminate SCI at your terminal. 
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If a pending foreground operation is active when you enter the Q command, this mes- 
sage appears: 


U SCI — 0048 QUIT OPERATION NOT VALID WITH <yyy> PENDING 
where: 


<yyy > represents the name of the operation(s), such as SCU (System Configu- 
ration Utility). 


To erase the message, press the Return key. You must complete the operation by using 
the command that terminates the pending operation, such as Quit Configuration Utility 
Session (QSCU). Reenter the Q command to terminate SCI. 


If a pending background task is active when you enter the Q command, the following 
message appears: 


U SCI — 0029 CANNOT QUIT WITH BACKGROUND TASK PENDING 
To erase the message, press the Return key. Allow the background task to complete. 


Reenter the Q command to terminate SCI at the terminal. 
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1.5 TEXT EDITOR FUNCTION KEYS 


On the VDT keyboard, designated keys activate all of the edit control functions. These functions 
consist of operations that change the editing position in the file, insert and delete data, move the 
cursor, display or suppress line numbers, and change editing modes. Table 1-1 lists the edit con- 


trol functions and their associated keys. 


Table 1-1. Edit Control Functions on a VDT 


Function 


Return to command mode 

Roll (display) up 

Roll (display) down 
Enable/disable word wrap 
Duplicate to tab 

Clear to tab 

Display/suppress line numbers 
Edit mode/compose mode 
Restore line 

New line (next line) 
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Generic Key Name 


Command 
F1 

F2 

F3' 

F4 

F5 

F6? 

F7" 

F8 

Return 
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Table 1-1. Edit Control Functions on a VDT (Continued) 


Function 


Forward tab 

Erase rest of line 
Forward space one character 
Backspace one character 
Back tab 

Right margin 

Left margin 

Erase characters on line 
Delete line 

Insert line 

Repeat 

Insert character 

Delete character 

Move cursor up 

Move cursor down 

Move cursor right 

Move cursor left 

Move cursor home 
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Generic Key Name 


Forward Tab 

Skip 

Next Character 
Previous Character 
Back Tab or Previous Field 
Next Field? 

Enter® 

Erase Field 

Erase Input 
Initialize Input 
Repeat 

Insert Character 
Delete Character 
Previous Line 

Next Line 

Next Character 
Previous Character 
Home 
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Table 1-1. Edit Control Functions on a VDT (Continued) 


Function Generic Key Name 
Enable/disable uppercase _ Uppercase Lock’ 
Control character codes Control 


Notes: 
' Alternates modes each time this key is pressed. 


2 Alternates display of line numbers (74 data characters per line) with no display of line numbers 
(80 data characters per line) each time this key is pressed. 


> The Next Field key and Enter key also function as horizontal scroll keys. 


For further information, refer to the DNOS Text Editor Manual. 


2270505-9701 | 1-11 General Operations 


1.6 USEFUL COMMAND SEQUENCES AND PROCEDURES 


Some procedures require a special sequence of commands. The following paragraphs identify 
some of these procedures. If you need to view the SCI prompts, enter the command at your ter- 
minal. If you want a detailed explanation of the prompts, refer to the DNOS System Command 
Interpreter (SCI) Reference Manual. 


1.6.1. Printing a KIF 

You cannot print the contents of a Key Indexed File (KIF) with the Print File (PF) command. Copy 
the KIF to a sequential file by using the Copy KIF to Sequential File (CKS) command. The CKS 
command copies the contents of a KIF to a sequential file in the order you specify. To specify the 
order, name a key by which the CKS command can read the file. For example, if you specify the 
number 2 for the KEY prompt, and that key contains zip codes, CKS reads the KIF by zip code as it 
is copied to the sequential medium. If you specify a device name in the form STxx or LPxx (where 
xx represents an integer) for the OUTPUT ACCESS NAME prompt, only the first 80 characters of 
each record are written to the device. | 


After you copy the KIF to a sequential file, you can execute the PF command and print the sequen- 
tial file. 
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| | } 


1.6.2 Showing a KIF 

The Show File (SF) command allows you to view a KIF in the order of the primary key. If you want to 
view the file in another order, use the CKS command. The previous paragraph discusses this 
command in greater detail. 


1.6.3 Spooler Recovery 
An unusual series of events can cause the spooler to stop functioning without allowing you to 
restart it. You must reinitialize the spooler environment by performing these steps: 
1. Use the Show Output Status (SOS) command to see which files are waiting to be printed 
and to see the current devices available to the spooler and the class names assigned to 
each. Write down this information for later use. 


2. Enter the Execute Operator Interface (XOl) command and then press the Command key 
| to return to SCI. 


3. Usethe List Jobs (LU) command to find the ID of the spooler job. 
4. Use the Kill Job (KJ) command to kill the spooler job. 


5. Use the Delete File (DF) command to delete the spooler queue file (known by the logical 
name S$SDTQUE). 
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6. Restart the spooler job by using the Execute Job (XJ) command. Examine the file 
.S$ISBTCH to see what responses your system uses to start the spooler job. The most 
common responses are shown in the following example. If your system uses different 
parameters from the parameters in this example, see the discussion concerning the 
spoolerin the DNOS Systems Programmer’s Guide for additional details. 


[ ]XJ 
EXECUTE JOB 


SITE NAME: 

JOB NAME: 

PROGRAM FILE PATHNAME: 
TASK ID OR NAME: 

PARM1: 

PARM2: 

STATION ID: 

SYNONYM TABLE PATHNAME: 
PRIORITY: 

JCA SIZE: 


EXECUTE JOB 


USE CURRENT USER ID?: 
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SPOOLER 
S$UTIL 
04D 

y 

, 


S$USER.SPOOLER.SYN 
<) 
MEDIUM 


NO 


General Operations 


EXECUTE JOB 
USERID: SPOOLER 
PASSCODE: 
ACCOUNT ID: 


7. Use the Modify Spooler Device (MSD) command and the list you made in step 1 to reas- 
sign all devices and classes to the spooler. 


8. Execute the PF command for each of the files that the SOS eommend showed as waiting 
to be printed. 


9. If you no longer have need to be the system operator, enter the Quit Operator Interface 
(QOl) command. 


1.6.4 Enabling Devices for the Spooler 

Until you assign device names, class names, and forms for each printer available to the spooler, 
the spooler cannot process print requests. Use the MSD command to assign printers and classes 
of printers to the spooler. 
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If you are uncertain of the assigned parameters, you can view the attributes of spooler devices by 
executing the SOS command. This command lists the device, form, status, and class name of 
a specified device or of all devices assigned to the spooler. If you want to change any of these 
attributes, such as adding a device to or removing one from use by the spooler, use the MSD 
command. | 


1.6.5 Recovering Lost Output After a Paper Jam 
If paper jams in the printer, you can recover damaged pages by following these steps: 


1. Execute the Halt Output at Device (HO) command to discontinue queued output 
temporarily. 


2. Unjam the paper. 

3. Execute the Resume Output at Device (RO) command. Respond to the PAGE SKIP 
prompt with the number of pages the output is to skip backward. Be sure to precede the 
number with a minus sign (—). If you enter a null response to this prompt, the output 


resumes at the point at which it was discontinued. Otherwise, the output resumes and 
begins printing at the page that you specified. 
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1.6.6 Changing the Number of Directory Entries 
Use the following procedure to increase or decrease the number of directory entries: 


1. Use the Create Directory File (CFDIR) command to create a new directory with the 
desired number of entries. 


2. Use the Copy Directory (CD) command to copy your original directory into the new direc- 
tory created in step 1. The CD command automatically duplicates the files and directo- 
ries in your original directory. 


3. Use the Delete Directory (DD) command to delete the original directory. 


4. Use the CFDIR command to create the original directory with the desired number of 
directory entries. 


5. Use the CD command to copy the new directory into the original directory. The original 
directory now contains the original files and subdirectories and has the desired number 
of entries. 


6. Use the DD command to delete the new directory you created in step 1. 
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NOTE 


In a file security environment, changing the number of directory 
entries with this procedure causes any secured files to become 
secured differently. Your creation access group will have all access 
rights to the files, but no other groups will have any access rights. 
You will need to reestablish file security. 


1.6.7 Copying a Program File 

Use the CD command to copy a program file. Specify the program file you want to copy as the 
input pathname. Specify the destination directory as the output pathname. You receive the fol- 
lowing message if you made only insertions (no deletions) to the program file you are copying and 
if adestination file does not exist: 


PROGRAM FILE COPIED USING FAST COPY 
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1.6.8 Copying a Crash File . 
Since .S$CRASH is an image file, use the CD command to copy it. Specify .SSSCRASH as the INPUT 


PATHNAME and adestination directory as the OUTPUT PATHNAME. This example creates the file 
.TEMPDIR.S$CRASH and copies from .S$CRASH to .TEMPDIR.S$CRASH. 


[JCD 
COPY DIRECTORY 

INPUT PATHNAME: .S$CRASH 

OUTPUT PATHNAME: .TEMPDIR 
CONTROL ACCESS NAME: 
LISTING ACCESS NAME: 

OPTIONS: ADD 
EXECUTION MODE(F,B): FOREGROUND 


1.6.9 Recognizing a System Crash 
You know the system has crashed when: 


e No terminal in the system responds to keyboard input. 
e The POWER, FAULT, IDLE, and RUN indicator lights on the front panel of the computer 


are lit. 
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You know the system is in acontinuous loop when: 
° No terminal in the system responds to keyboard input. 
e The POWER and RUN indicator lights on the front panel of the computer are lit. 


The pattern in the data lights on the front panel after a system crash represents a hexadecimal 
crash code. The DNOS Messages and Codes Reference Manual lists the crash codes. 


System crashes occur as the result of critical hardware errors or failures in system software. When 
a crash occurs, analyze the crash dump to determine the cause. If you cannot determine the cause, 
send acopy of the dump on magnetic tape or disk, copies of the system link maps, and a descrip- 
tion of the events preceding the crash to your customer representative. 
1.6.10 Dumping the Contents of Memory to .S$CRASH 
When asystem crash occurs, the system idles, waiting for you to take action. To analyze the cause 
of the system crash, dump the contents of memory to the crash file as follows: 

1. | Press HALT on the front panel. 


2. Press RUN on the front panel. 
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The file SSS6CRASH now receives the contents of memory. When the dump is complete, the IDLE 
light comes on again. Perform an initial program load (IPL) as detailed in the next paragraph. You 
can examine the crash dump by using the Execute Crash Analysis Utility MANAL) command. For 
more information about this command, refer to the DNOS System Command Interpreter (SCI) 
Reference Manual and the DNOS System Programmer’s Guide. 


If you cannot analyze the crash dump immediately, you can copy the contents of .S$CRASH to a 
file in another directory. Refer to Copying a Crash File in this section. Make this copy as soon as 
possible after you perform the IPL on the system. By having a copy of .SS$CRASH, you can safely 
perform another dump, if necessary, without losing the information from the previous one. 
1.6.11 Performing an IPL After a Crash 
After you dump the contents of memory following a system crash, you must perform an IPL to 
reactivate the system. Use this procedure: 

1. Press HALT on the front panel. 

2. Press LOAD on the front panel. DNOS is now loaded into memory. 


3. Logonto aterminal. 
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4. Optionally, enter the PF command to print the system log files (.S$LOG1 and .S$LOG2). 


5. Optionally, copy the system crash file (.S$CRASH) to another file by using the CD com- 
mand. Refer to Copying a Crash File in this section. 


If the problem occurs again, contact your customer representative. You should send the represen- 
tative a copy of the crash file on magnetic tape or disk, system link maps, and a description of the 
events preceding the crash. 


1.6.12 Forcing a System Crash 

Certain problems in the system do not result in a system crash, but they prevent useful work on 
the system. The system malfunctions, but the FAULT light is not lit. For example, a system routine 
may hang in aloop or adeadlock condition. In such cases, force a system crash to obtain the crash 
dump for analysis. 


Model 990 and Business System minicomputers have slightly different procedures for forcing a 
system crash. 
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1.6.12.1_ Model 990 Minicomputers. The following procedure forces a crash on Model 990 mini- 


computers: 


1. Press HALT twice. 


2. Press the following in sequence: 


a. 
b. 
C. 
d. 
e. 


3. Thesystem crashes with acrash code of >62. 
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PC DISPLAY 
MA ENTER 
CLR 

MDE 


RUN 
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4. Dump the contents of memory to the .S$CRASH file by pressing HALT and then RUN. 
Refer to Dumping The Contents of Memory to .S$CRASH in this section. 


5. Performan IPL. 


1.6.12.2 Business Systems Minicomputers. The following procedure forces a crash on Busi- 
ness Systems minicomputers: 


1. Press HALT 11 times. 
2. Press RUN. 


3. Dump the contents of memory to the .S$CRASH file by pressing HALT and then RUN. 
Refer to Dumping the Contents of Memory to .S$CRASH in this section. 


4. Perform an!PL. 


For further information, refer to the DNOS Operations Guide. 
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| Using SCI 


2.1 INTRODUCTION 


SCI provides a set of commands and utilities for use with DNOS. SCI commands are grouped by 
function into menus. The SCI main menu displays the names of the command groups. By entering 
a command group menu name in response to the SCI prompt ([ ]), you can view the associated 
commands of a group. When using SCI, various function keys are used for the entry and control of 
SCI commands. Also, new SCI commands can be built with SCI primitives. This section describes 
SCI function keys and lists SCI primitives. 


2.2 SCI FUNCTION KEYS 


Table 2-1 lists the keys that have special terminal control functions when SCI is accepting user 
responses to field prompts on a terminal in VDT mode. Table 2-2 shows the special terminal con- 
trol keys that can be used when an SCI command is executing while the terminal is in VDT mode. 
Table 2-3 describes additional procedures that can be used for Terminal Local File displays. 
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Table 2-1. VDT Mode Command Entry Keys 
Key Function 


Home Positions the cursor at the beginning of the response field of the first field 
prompt displayed on the screen. You can reenter responses to all of the field 
prompts. The Home key does not allow you to go back to a previously dis- 
played set of field prompts of the same command. 


Return Used to accept the current response to the field prompt. It is also used to posi- 
tion the cursor in the response field of the next field prompt or to start com- 
mand processing if the command has no more field prompts. 

Skip Deletes all characters to the right of the cursor when it is positioned in the 
response field of the current field prompt and moves the cursor position to the 
start of the response field of the next field prompt. 


Next Field Moves the cursor position to the start of the response field of the next field 
prompt. If there are no more field prompts, the command executes. 


Previous Field Moves the cursor position to the start of the previous response field. 
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Table 2-1. VDT Mode Command Entry Keys (Continued) | 


Key Function 

Erase Field Deletes an entire response to a field prompt including any initial value sup- 
plied by the system. You can then enter a new response to the same field 
prompt. 

Erase Input Resets any initial values and goes to the first field prompt displayed on the 
terminal. The initial values are reset only for the set of field prompts currently 
displayed. 

Command Aborts a command currently accepting user responses and returns the ter- 


minal to command mode. 

F4 Causes duplication of the corresponding field from the previous line. This key 
does not cause field termination. You can either accept the duplicated field by 
pressing the Return key or modify the duplicated field before accepting it. 


Back Tab Positions the cursor to the beginning of the response field for the current field 
prompt. 
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Table 2-1. VDT Mode Command Entry Keys (Continued) 


Key 


Forward Tab 
Previous Line 

Next Line 

Previous Character 


Next Character 
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Function 


Moves the cursor to the next pathname component in the current response 
field. At the end of the pathname, the cursor is positioned to the beginning of 
the current response field. 


Positions the cursor to the same character position in the response field of 
the previous field prompt. If there is no previous field prompt, the cursor 
position is unchanged. 


Positions the cursor to the same character position in the response field of 
the next field prompt. If there is no next field prompt, the cursor position is 
unchanged. 


Moves the cursor one position to the left in the response field of the current 
field prompt. 


Moves the cursor one position to the right in the response field of the current 
field prompt. 
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Table 2-1. VDT Mode Command Entry Keys (Continued) 
Key Function 


Enter Enters responses to all field prompts as displayed. If asyntax error occurs, the 
cursor is positioned to the first character position of the field prompt 
response field containing the syntax error. 


Repeat Repeats the key function when used in conjunction with any key. 


Insert Character Allows you to insert new characters, beginning at the current cursor position 
in the response field of the current field prompt. Any characters currently in 
the response field are shifted to the right. Characters can be inserted until the 
response field is full. 


Delete Character Deletes a character beginning at the cursor position and shifts the remaining 
characters in the response field of the field prompt one character position to 
the left. 
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Table 2-2. Control Keys for Commands Executing in VDT Mode 
Key Function 


Attention Temporarily stops output at a terminal. Pressing any alphabetic or numeric 
key continues output. 


Attention then Return Returns an error to the executing task. Most DNOS tasks programmed by 
Texas Instruments abort when the error is returned to the task. However, you 
can program a task to continue execution if you desire. 


Attention then Aborts the executing commands that can be aborted to return control to the 

Control and X user. One task is killed each time the break key sequence is used. If only SCl is 
active, it is killed, the job at the terminal terminates, and the terminal is again 
available for use. If tasks other than SCI are active, the order in which tasks are 
killed is: foreground tasks, background tasks, and SCI. If this control key 
sequence is issued to a terminal not logged on to SCI, the log-on prompts 
appear, but no task is bid and the log-on prompts remain on the screen. (To log 
on SCI, perform the normal log-on procedure of pressing the attention key fol- 
lowed by the exclamation point.) 
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Table 2-2. Control Keys for Commands Executing in VDT Mode (Continued) 


Key Function 


Attention then Print Prints the contents of a video display terminal (VDT) on the nominated hardcopy 
printer attached to your DNOS system. Each VDT can have a different printer 
nominated as its output device. This task works with 911, 931, and 940 VDTs 
without any modification to the device service routines (DSRs) or the operating 
system. 


You can optionally add header information to your printout. Refer to the DNOS 


System Programmer’s Guide for more information on the header option and 
printer selection. This currently does not work across a local area network. 
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Table 2-3. Additional Procedures for Terminal Local File Displays 


Key Function 
+ Integer then Entering a plus sign (+), an integer (decimal or hexadecimal), then pressing 
Return the Return key, positions the display of the file contents ahead the number of 


lines specified by the integer. 


Integer then Entering an integer (decimal or hexadecimal) and pressing the Return key 
Return positions the display of the file contents to the line specified by the integer. 

— Integer then Entering a minus sign (—), an integer (decimal or hexadecimal), and then 
Return pressing the Return key, positions the display of the file contents back the 


number of lines specified by the integer. 


F 1 Causes the display of the next portion of a file (the amount displayed depends 
on the type of terminal). When the end-of-file is reached, pressing the F1 key 
has no further effect. 


F2 Causes the display of a previous portion of a file. If the beginning of the file is 
displayed, the F2 key has no effect. 
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Table 2-3. Additional Procedures for Terminal Local File Displays (Continued) 


Key Function 


F3 Causes the display to scroll horizontally 10 columns to the left. Scrolling may 
continue through column 170. The bottom line of the VDT screen displays a 
scaling line, unless the display is positioned in column 1. The last character 
which can be shown is in character position 240 of the input record. The ter- 
minal must be in default VDT mode (see the MTS command) for this function 
to operate as described. 


F4 Causes the display to scroll horizontally 10 columns to the right. The bottom 
line of the VDT screen displays a scaling line, unless the display is positioned 
in column 1. The terminal must be in default VDT mode (see the MTS com- 
mand) for this function to operate as described. 


F6 Causes line numbers to be displayed in the leftmost columns of the VDT 
screen. Pressing the F6 key again causes the line numbers to be removed from 
the screen. The terminal must be in default VDT mode (see the MTS command) 
for this function to operate as described. 
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For further information, refer to the DNOS SCI Reference Manual. 


2.3 SCI PRIMITIVES 


Table 2-4 lists the SCI primitive notations, and Table 2-5 lists the available primitives and their 
associated parameters. Primitives are used to build batch streams and new SCI commands. 
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Notation 


Uppercase 
Lowercase 
No marks 
[] 
Item...item 


/ 
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Table 2-4. SCI Primitive Notation 
Meaning 


Enter the item as shown. 

Enter an item of this type. 

Indicates required items. 

Indicates optional items. 

You can use more than one item of this type. Separate items with commas. 


Indicates alternate items. 
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Table 2-5. SCI Primitives 





Primitive 
Command Parameters 

.PROC name[(full name)]{ = int\[,field prompt list] 

.EOP 

.PROMPT [((full name)]{ = int\[, field prompt list] 

SYN name = “‘value”’ ...name = “value” 

“EVAL [mode][ = YES/NO,] name = value 

SPLIT LIST = (/ist)[,FIRST = name][,REST = name] 
LIST = “string” [,FIRST = name][,REST = name] 
[CHARACTER = “‘string’’|[, POSITION = int], STATUS = name] 

SVC [Sname]DATA/BYTE/TEXT = value(s)... 


[Sname]DATA/BYTE/TEXT = value(s) 
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Table 2-5. 


Primitive 
Command 


AF 


.ELSE 


-ENDIF 


-LOOP 


WHILE 


-REPEAT 


UNTIL 


-EXIT 


SCI Primitives (Continued) 


Parameters 


op7, relation, op2 


op7, relation, op2 


op7, relation, op2 
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Primitive 
Command 


.BID 


-DBID 


-QBID 


DATA 


-EOD 


STOP 


Table 2-5. SCI Primitives (Continued) 


Parameters 


TASK = namelint[, LUNO = int][, CODE = int] 
[,PROGRAM FILE = acnm][,PARMS = (string...string)] 
[UTILITY] 


TASK = namelint[,LUNO = int], CODE = int] 

[,PROGRAM FILE = acnm][,PARMS = (string...string)] 
[UTILITY] 

TASK = namelint[, LUNO = int][,CODE = int] 

[,PROGRAM FILE = acnm],PARMS = (string...string)] 
[UTILITY] 

[acnm][,EXTEND[ = YES/NO]][, SUBSTITUTION[ = YES/NO]] 
[,REPLACE| = YES/NO]] 

[TEXT = string][,CODE = int] 
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Table 2-5. SCI Primitives (Continued) 


Primitive 
Command 


.USE 


OPTION 


MENU 


SHOW 


Parameters 


[pathname...pathname] 


[PROMPT[ = string]][, MENU[ = name]] 
[,PRIMITIVES[ = YES/NO]][,_LOWERCASE[ = YES/NO]] 


[menu name] 


filename...filename 


For further information refer to the DNOS Systems Programmer's Guide. 
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Assembly Language Instructions and Formats 


3.1 INTRODUCTION 


The assembly language instructions and formats in this section are for the Model 990 and Busi- 
ness Systems computers. This section lists assembly language instructions numerically by 
hexadecimal operation code (opcode), and alphabetically by mnemonic opcode; and it includes 
the assembly language instruction formats. It also includes assembly language addressing 
modes, the status register, workspace pointer and registers, macro language statements, macro 
language variable components, and object code format. 


3.2 ASSEMBLY LANGUAGE INSTRUCTION FORMATS 


Figure 3-1 shows the assembly language instruction formats. 
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FORMAT USE 


(ARITH) 
(JUMP) 
(LOGICAL) 


(CRU) 
(SHIFT) 


(PROGRAM) 


(CONTROL) 


(IMMEDIATE ) 
WORD 1 


(MPY ,DIV ,XOP) 


(MEMORY MAP FILE 


OPTION) 


(MULTIPLE # 
PRECISION) 


(STRING)* 


2282796 


2270505-9701 


< 


INSTRUCTION FORMATS 











dah ete» l=] = | 
SIGNED DISPLACEMENT 


OPCODE 


OPCODE 


wraooe a 


IMMEDIATE VALUE 


oreeee P| 


OPCODE 


Ps an 
See oe ee as 


OPCODE 


c ie 
ee Ee a ee es eee 


712 ONLY 


Figure 3-1. 


FORMAT USE 
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1S. 


16. 


19. 


20. 
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3.3 ADDRESSING MODES 


The assembly language features eight addressing modes. Three of these modes—program 
counter relative addressing, CRU bit addressing, and immediate addressing—are special purpose 
addressing modes. For more information on these modes, read the Assembly Language 
Reference Manual. The remaining five modes in the instructions specify a general address for the 
source or destination operand. Table 3-1 lists these modes and shows how to use each in assem- 
bly language. Each addressing format describes the T field as Ts and Td. 


Table 3-1. Addressing Modes 


Addressing Mode T Field Value Example Notes 


Workspace Register 0 R5 
Workspace Register 1 *R7 
Indirect 

Workspace Register 3 *R/7 + 


Indirect Autoincrement 
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Table 3-1. Addressing Modes (Continued) 


Addressing Mode T Field Value Example Notes 
Symbolic Memory 2 @LABEL 1,2 
Indexed Memory 2 @ LABEL(5) 1,3 
Notes: 


1. The instruction requires an additional word for each T field value of 2. This word contains a memory 
address. 


2. The assembler sets the S or D field to 0. 


3. Youcannot use workspace register 0 for indexing. 
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3.4 ASSEMBLY LANGUAGE BY OPCODE 


Table 3-2 lists all assembly language instructions by hexadecimal opcode and includes the status 
bits affected. Numbers listed in the format column refer to the instruction formats presented in 


Figure 3-1. 


Hexadecimal 
Operation 


Code 
001C 
001D 
OO1E 
O01F 


0020 
0021 
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Table 3-2. Hexadecimal Instruction Table 


Mnemonic 
Operation 
Code 


SRAM 
SLAM 
RTO 
LTO 
CNTO 
SLSL 


Status Bits 
Name Format Affected 
Shift Right Arithmetic Multiple Precision 13 0-3 
Shift Left Arithmetic Multiple Precision 13 0-4 
Right Test for One 11 2 
Left Test for One 11 2 
Count Ones 11 2 
Search List Logical Address 20 2 
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Hexadecimal 
Operation 
Code 


0022 
0023 
0024 
0025 
0026 
0027 
0028 
0029 
002A 
002B 
002D 
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Table 3-2. 


Mnemonic 
Operation 
Code 


SLSP 
BDC 
DBC 
SWPM 
XORM 
ORM 
ANDM 
SM 
AM 
MOVA 
EMD 


Hexadecimal Instruction Table (Continued) 


Name 


Search List Physical Address 
Binary to Decimal ASCII Conversion 
Decimal to Binary ASCII Conversion 
Swap Multiple Precision 

Exclusive OR Multiple Precision 

OR Multiple Precision 

AND Multiple Precision 

Subtract Multiple Precision Integer 
Add Multiple Precision Integer 
Move Address 


Execute Micro-Diagnostic 


Format 


20 
11 
11 
11 
11 
11 
11 
11 
11 
19 
7 


Status Bits 
Affected 


0-2, 4 
0-2,4 
0-2 
0-2 
0-2 
022 
0-4 
0-4 
0-2 
0-15 
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Hexadecimal 
Operation 
Code 


002E 
002F 
0030 
0040 
0050 
0060 
0070 
0080 
0090 
OOAO 
OOBO 
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Mnemonic 
Operation 
Code 


EINT 
DINT 
STPC 
cs 
SEQB 
Movs 
LIM 
LST 
LWP 
LCS 
BLSK 


Hexadecimal Instruction Table (Continued) 


Name 


Enable Interrupts 

Disable Interrupts 

Store Program Counter 
Compare Strings 

Search String for Equal Byte 
Move String 

Load Interrupt Mask 

Load Status Register 

Load Workspace Pointer 


Load Writable Control Store 


Format 


18 
12 
12 
12 
18 
18 
18 
18 


Branch Immediate and Push Link to Stack 8 


3-7 


Status Bits 
Affected 


0-2 
0-2 
0-2 
12-15 
0-15 
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Table 3-2. Hexadecimal Instruction Table (Continued) 


Hexadecimal Mnemonic 


Operation Operation Status Bits 
Code Code Name Format Affected 
00CO MVSR Move String Reverse 12 0-2 
OODO MVSK Move String From Stack | 12 0-2 
OOEO POPS Pop String From Stack 12 0-2 
OOFO PSHS Push String From Stack 12 0-2 
0140 BIND Branch Indirect 6 — 

0180 DIVS Divide Signed 6 0-2,4 
01C0 MPYS Multiply Signed 6 0-2 
0200 LI Load Immediate 8 0-2 
0220 Al Add Immediate 8 0-4 
0240 ANDI AND Immediate 8 0-2 
0260 ORI OR Immediate 8 0-2 
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Hexadecimal 
Operation 
Code 


0280 
-02A0 
02C0 
02E0 
0300 
0320 
0340 
0360 
0380 
03A0 
03C0 
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Mnemonic 
Operation 
Code 


Cl 
STWP 
STST 
LWPI 
LIMI 
LMF 
IDLE 
RSET 
RTWP 
CKON 
CKOF 


Hexadecimal Instruction Table (Continued) 


Name Format 
Compare Immediate 8 
Store Workspace Pointer 18 
Store Status 18 


Load Workspace Pointer Immediate 


Load Interrupt Mask Immediate 8 


Load Memory Map File 10 


Idle 


Reset 


Return With Workspace Pointer 


Clock On 
Clock Off 


NN N N WN 


Status Bits 
Affected 


0-2 
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Table 3-2. Hexadecimal Instruction Table (Continued) 


Hexadecimal Mnemonic 
Operation Operation Status Bits 
Code Code Name Format Affected 
03E0 LREX Load or Restart Execution 7 12-15 
03F0 EP Extended Precision 21 0-2 
0400 BLWP Branch and Load Workspace Pointer 6 — 
0440 B Branch 6 — 
0480 X Execute 6 — 
04C0 CLR Clear 6 — 
0500 NEG Negate 6 0-4 
0540 INV Invert 6 0-2 
0580 INC Increment 6 0-4 
05CO INCT Increment by Two 6 0-4 
0600 DEC Decrement 6 0-4 
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Table 3-2. Hexadecimal Instruction Table (Continued) 


Hexadecimal Mnemonic 


Operation Operation Status Bits 
Code Code Name | Format Affected 
0640 DECT Decrement by Two 6 0-4 
0680 BL Branch and Link 6 i 
06CO0 SWPB Swap Bytes 6 = 
0700 SETO Set to One 6 — 

0740 ABS Absolute Value 6 0-4 
0780 LDS Long Distance Source 6 _ 

07C0 LDD Long Distance Destination 6 az 

0800 SRA Shift Right Arithmetic 5 0-3 
0900 SRL Shift Right Logical 5 0-3 
OA00 SLA Shift Left Arithmetic 5 0-4 
OBOO SRC Shift Right Circular 5 0-3 
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Table 3-2. Hexadecimal Instruction Table (Continued) 


Hexadecimal Mnemonic 


Operation Operation Status Bits 
Code Code Name Format Affected 
OCO00 CRI Convert Real to Integer 7 0-4 
0CO01 CDI Convert Double Precision Real to Integer 7 0-4 
0C02 NEGR Negate Real 7 0-2 
0C03 NEGD Negate Double Precision i 0-2 
0C04 CRE Convert Real to Extended Integer 7 0-4 
O0CO05 CDE Convert Double Precision 

Real to Extended Integer 7 0-4 
0C06 CER Convert Extended Integer to Real 7 0-2 
0C07 CED Convert Extended Integer 

to Double Precision Real 7 0-2 
0C08 NRM Normalize 11 0-2 
OCO9 TMB Test Memory Bit 14 2 
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Table 3-2. Hexadecimal Instruction Table (Continued) 


Hexadecimal Mnemonic 


Operation Operation Status Bits 
Code Code Name Format Affected 
OCOA TCMB Test and Clear Memory Bit 14 2 
OCOB TSMB Test and Set Memory Bit 14 2 
OCOC SRJ Subtract From Register and Jump 17 — 
OCOD ARJ Add to Register and Jump 17 — 
OCOE/ XIT Exit From Floating 
OCOF Point Interpreter 7 — 
0C10 INSF Insert Field 16 0-2 
0C20 XV Extract Value 16 0-2 
0C30 XF Extract Field 16 0-2 
0C40 AR Add Real 6 0-4 
0C80 CIR 6 0-2 
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Convert Integer to Real 


3-13 Assembly Language Instructions and Formats 


Hexadecimal 
Operation 
Code 


1600 
1700 
1800 
1900 
1A00 
1B00 
1C00 
1D00 
1E00 
1F00 
2000 
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Table 3-2. Hexadecimal Instruction Table (Continued) 


Mnemonic 
Operation 
Code 


JNE 
JNC 
JOC 
JNO 
JL 
JH 
JOP 
SBO 
SBZ 
TB 
COC 


Name 


Jump if Not Equal 

Jump if No Carry 

Jump on Carry 

Jump if No Overflow 
Jump if Logical Low 
Jump if Logical High 
Jump if Odd Parity 

Set CRU Bit to Logic One 
Set CRU Bit to Logic Zero 
Test Bit 


Compare Ones Corresponding 


3-16 


Status Bits 
Format Affected 


© PrP po PO MB DMPO NMP NY KNB NM NY 
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Hexadecimal 
Operation 
Code 
OECO 
OFOO 
OF 40 
OF80 
OFCO 
1000 
1100 
1200 
1300 
1400 
1500 
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Table 3-2. 


Mnemonic 
Operation 
Code 


SD 
MD 
DD 
LD 
STD 
JMP 
JLT 
JLE 
JEQ 
JHE 
JGT 


Hexadecimal Instruction Table (Continued) 


Name 


Subtract Double Precision Real 


Multiply Double Precision Real 


Divide Double Precision Real 
Load Double Precision Real 
Store Double Precision Real 
Unconditional Jump 

Jump if Less Than 

Jump if Low or Equal 

Jump if Equal 

Jump if High or Equal 


Jump if Greater Than 
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Status Bits 
Format Affected 
0-4 
0-4 
0-4 
0-2 
0-2 


Ph PO PO DP NO NO OO DD OHO OH OO 
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Table 3-2. Hexadecimal Instruction Table (Continued) 


Hexadecimal Mnemonic = 
Operation Operation Status Bits 
Code Code Name Format Affected 
OCCO SR Subtract Real 6 0-4 
ODOO MR Multiply Real 6 0-4 
0D40 DR Divide Real 6 0-4 
0D80 LR Load Real 6 0-2 
ODCO STR Store Real 6 0-2 

OE00 lOF Invert Order of Field 15 a, 
0E10 SNEB Search String for Not Equal Byte 12 0-2 
OE20 CRC Cyclic Redundancy Code Calculation 12 2 
OE30 TS Translate Strings 12 0-2 
OE40 AD Add Double Precision Real 6 0-4 
OE80 CID Convert Integer to Double Precision Real 6 0-2 
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Hexadecimal 
Operation 
Code 
OECO 
OFOO 
OF 40 
OF80 
OFCO 
1000 
1100 
1200 
1300 
1400 
1500 
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Table 3-2. 


Mnemonic 
Operation 
Code 


SD 
MD 
DD 
LD 
STD 
JMP 
JLT 
JLE 
JEQ 
JHE 
JGT 


Hexadecimal Instruction Table (Continued) 


Name 


Subtract Double Precision Real 


Multiply Double Precision Real 


Divide Double Precision Real 
Load Double Precision Real 

Store Double Precision Real 

Unconditional Jump 

Jump if Less Than 

Jump if Low or Equal 

Jump if Equal 

Jump if High or Equal 


Jump if Greater Than 
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Status Bits 
Format Affected 
0-4 
0-4 
0-4 
0-2 
0-2 


NM RP PO DO NYO DO OD WD HD OM 
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Hexadecimal 
Operation 


Code 


OCCO 
OD00 
0D40 
OD80 
ODCO 
OEOO 
0E10 
OE20 
OE30 
OE40 
OE80 
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Table 3-2. 


Mnemonic 
Operation 
Code 


SR 
MR 
DR 
LR 
STR 
lOF 
SNEB 
CRC 
TS 
AD 
CID 


Hexadecimal Instruction Table (Continued) 


Name Format 
Subtract Real 6 
Multiply Real 6 
Divide Real 6 
Load Real 6 
Store Real 6 
Invert Order of Field 15 
Search String for Not Equal Byte 12 
Cyclic Redundancy Code Calculation 12 
Translate Strings 12 
Add Double Precision Real 6 
Convert Integer to Double Precision Real 6 | 
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Status Bits 
Affected 


0-4 
0-4 
0-4 
0-2 
0-2 
022 
2 

0-2 
0-4 
0-2 
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Hexadecimal 
Operation 
Code 


2400 
2800 
2C00 
3000 
3400 
3800 
3000 
4000 
5000 
6000 
7000 
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Table 3-2. 


Mnemonic 
Operation 


Code 


CZC 
XOR 
XOP 
LDCR 
STCR 
MPY 
DIV 
SZC 
SZCB 
S 

SB 


Name 


Compare Zeros Corresponding 
Exclusive OR 

Extended Operation 

Load Communication Register 
Store Communication Register 
Multiply 

Divide | 

Set Zeros Corresponding 

Set Zeros Corresponding, Byte 
Subtract Words 

Subtract Bytes 


Hexadecimal Instruction Table (Continued) 


Format 


oO Oo -& FF O WO W 


_s 


Status Bits 
Affected 


0-2 


0-2,5 
0-2,5 
4 

0-2 
0-2,5 


“1024 


0-5 
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Table 3-2. 


Hexadecimal Instruction Table (Continued) 





Hexadecimal Mnemonic 
Operation Operation Status Bits 

Code Code Name Format Affected 
8000 C Compare Words 1 0-2 

9000 CB Compare Bytes : 1 0-2,5 
A000 A Add Words | 0-4 

Boo0 AB Add Bytes 0-5 

C000 MOV Move Word 0-2 

DOOO MOVB Move Byte 0-2,5 
E000 SOC Set Ones Corresponding 0-2 

FOOO SOCB Set Ones Corresponding, Byte 1 0-2,5 
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3.5 ALPHABETICAL LIST OF ASSEMBLY LANGUAGE INSTRUCTIONS 


Table 3-3 lists all assembly language instructions alphabetically by mnemonic opcode. Numbers 
listed in the format column refer to the instruction formats presented in Figure 3-1. An asterisk (*) 
preceding a mnemonic opcode indicates that the instruction is available only on the 990/12 or 
Business System 800 computer; two asterisks (**) indicate that the instruction is available on the 
990/12, the 990/10A, and the Business System computers. 


Table 3-3. Alphabetical List of Assembly Language Instructions 


Mnemonic Hexadecimal 
Operation Code Name Operation Code Format Notes 

A Add Words A000 1 
AB Add Bytes. BOOO 1 
ABS Absolute Value 0740 6 5 

* AD Add Double Precision Real OE40 6 
Al Add Immediate 0220 8 

* AM Add Multiple Precision Integer 002A 11 
ANDI AND Immediate 0240 8 
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Table 3-3. Alphabetical List of Assembly Language Instructions (Continued) 


Mnemonic 


Operation Code 


ANDM 
AR 
ARJ 

B 
BDC 
BIND 
BL 
BLSK 
BLWP 
C 

CB 
CDE 


CDI 
CED 


CER 
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Name 


AND Multiple Precision 

Add Real 

Add to Register and Jump 

Branch 

Binary to Decimal ASCII Conversion 

Branch Indirect 

Branch and Link 

Branch Immediate and Push Link to Stack 

Branch and Load Workspace Pointer 

Compare Words 

Compare Bytes 

Convert Double Precision Real to 
Extended Integer 

Convert Double Precision Real to Integer 

Convert Extended Integer to Double 
Precision Real 

Convert Extended Integer to Real 
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Hexadecimal 


Operation Code Format Notes 
0028 11 
0C40 6 
OCOD 17 
0440 6 
0023 11 
0140 6 
0680 6 
OOBO 8 
0400 6 
8000 1 
9000 1 
0C05 7 
0C01 7 
0C07 7 
OC06 7 


Assembly Language Instructions and Formats 


Table 3-3. Alphabetical List of Assembly Language Instructions (Continued) 


Mnemonic 
Operation Code 


Cl 
* CID 


* CIR 
CKOF 
CKON 
CLR 

* CNTO 

COC 

CRC 

CRE 

CRI 

CS 

CZC 

* DBC 

* DD 
DEC 


+ + * * 
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Name 


Compare Immediate 
Convert Integer to Double 

Precision Real 
Convert Integer to Real 
Clock Off 
Clock On 
Clear 
Count Ones 
Compare Ones Corresponding 
Cyclic Redundancy Code Calculation 
Convert Real to Extended Integer 
Convert Real to Integer 
Compare Strings 
Compare Zeros Corresponding 
Decimal to Binary ASCII Conversion 
Divide Double Precision Real 
Decrement 
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Hexadecimal 
Operation Code Format Notes 


0280 


mee) 


OE80 
0C80 
03C0 
03A0 
04C0 
0020 
2000 
OE20 
0C04 
0C00 
0040 
2400 
0024 
OF 40 
0600 


eb Pk 
RD 


Ss 


NO 


OO WANNA WAOANNODO 
— nh 
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Table 3-3. Alphabetical List of Assembly Language Instructions (Continued) 


Mnemonic 
Operation Code 


DECT 
* DINT 
DIV 
DIVS 
DR 
EINT 
EMD 
EP 
IDLE 
INC 
INCT 
* INSF 

INV 
* IOF 

JEQ 

JGT 

JH 


+ * % * * 
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Name 


Decrement by Two 
Disable Interrupts 
Divide 

Divide Signed 

Divide Real 

Enable Interrupts 
Execute Micro-Diagnostic 
Extended Precision 
Idle 

Increment 
Increment by Two 
Insert Field 

Invert 

Invert Order of Field 
Jump if Equal 

Jump if Greater Than 
Jump if Logical High 
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Hexadecimal 
Operation Code 


0640 
002F 
3C00 
0180 
0D40 
002E 
002D 
O03F0 
0340 
0580 
05C0 
0C10 
0540 
OEOO 
1300 
1500 
1B00 


Format Notes 


owk 


1,4 


POMONA OH] DONNY NN OD ON DD 
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Table 3-3. Alphabetical List of Assembly Language Instructions (Continued) 


Mnemonic 
Operation Code 


JHE 
JL 
JLE 
JLT 
JMP 
JNC 
JNE 
JNO 
JOC 
JOP 

* LCS 

* LD 
LDCR 
LDD 
LDS 
LI 

* LIM 
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Name 


Jump if High or Equal 
Jump if Logical Low 

Jump if Low or Equal 

Jump if Less Than 
Unconditional Jump 

Jump if No Carry 

Jump if Not Equal 

Jump if No Overflow 

Jump on Carry 

Jump if Odd Parity 

Load Writable Control Store 
Load Double Precision Real 
Load Communication Register 
Long Distance Destination 
Long Distance Source 

Load Immediate 

Load Interrupt Mask 
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Hexadecimal 
Operation Code Format Notes 


1400 
1A00 
1200 
1100 
1000 
1700 
1600 
1900 
1800 
1C00 
OOA0 
OF80 
3000 
07C0 
0780 
0200 
0070 


ADO DODADANMNNNNNNNN NM 


a a 
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Table 3-3. Alphabetical List of Assembly Language Instructions (Continued) 


Mnemonic Hexadecimal 
Operation Code Name Operation Code Format Notes 
LIMI Load Interrupt Mask Immediate 0300 8 1 
LMF Load Memory Map File 0320 10 1 
* LR Load Real OD80 6 
LREX Load or Restart Execution O3E0 7 1,4 
** LST. Load Status Register 0080 18 
* LTO Left Test for One O01F 11 
** LWP Load Workspace Pointer 0090 18 
LWPI Load Workspace Pointer Immediate O2E0 8 
* MD Multiply Double Precision Real OFOO 6 
MOV Move Word C000 1 
* MOVA Move Address 002B 19 
MOVB Move Byte DOOO 1 
* MOVS Move String 0060 12 
MPY Multiply 3800 9 
** MPYS Multiply Signed 01C0 6 
* MR Multiply Real ODO0O0 6 
* MVSK Move String From Stack 0ODO 12 
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Table 3-3. Alphabetical List of Assembly Language Instructions (Continued) 
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3°25 


Mnemonic Hexadecimal 

Operation Code Name Operation Code Format Notes 
MVSR Move String Reverse 00CO 12 
NEG Negate 0500 6 
NEGD Negate Double Precision 0C03 7 
NEGR Negate Real 0C02 7 
NRM Normalize 0C08 11 
ORI OR Immediate 0260 8 
ORM OR Multiple Precision 0027 11 
POPS Pop String From Stack OOEO 12 
PSHS Push String From Stack OOFO 12 
RSET Reset 0360 7 1,4 
RTO Right Test for One OO1E 11 
RTWP Return With Workspace Pointer 0380 7 2 
S Subtract Words 6000 1 
SB Subtract Bytes 7000 1 
SBO Set CRU Bit to Logic One 1D00 2 
SBZ Set CRU Bit to Logic Zero 1E00 2 
SD Subtract Double | OECO 6 
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Table 3-3. Alphabetical List of Assembly Language Instructions (Continued) 


Mnemonic 
Operation Code 


SEQB 
SETO 
SLA 
SLAM 
SLSL 
SLSP 
SM 
SNEB 
SOC 
SOCB 
SR 
SRA 
SRAM 
SRC 
SRdJ 
SRL 
STCR 
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Name 


Search String for Equal Byte 

Set to One 

Shift Left Arithmetic 

Shift Left Arithmetic Multiple Precision 
Search List Logical Address 

Search List Physical Address 

Subtract Multiple Precision Integer 
Search String for Not Equal Byte 

Set Ones Corresponding 

Set Ones Corresponding, Byte 
Subtract Real 

Shift Right Arithmetic 

Shift Right Arithmetic Multiple Precision 
Shift Right Circular 

Subtract from Register and Jump 

Shift Right Logical 

Store Communication Register 
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Hexadecimal 


Operation Code Format Notes 


0050 12 

0700 6 

OA0O0 ss) 

001D 13 

0021 13 

0022 20 1 
0029 11 

0E10 12 

E000 1 

FOOO 1 

OCCO 6 

0800 re) 

001C 13 

OBOO 5 

OCOC 17 

0900 s) 

3400 4A 3 
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Table 3-3. 


Mnemonic 
Operation Code 


STD 
STPC 
STR 
STST 
STWP 
SWPB 
SWPM 
SZC 
SZCB 
TB 
TCMB 
TMB 
TS 
TSMB 
X 

XF 
XIT 
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Name 


Store Double Precision Real 
Store Program Counter 

Store Real 

Store Status 

Store Workspace Pointer 
Swap Bytes 

Swap Multiple Precision 

Set Zeros Corresponding 

Set Zeros Corresponding, Byte 
Test Bit 

Test and Clear Memory Bit 
Test Memory Bit 

Translate Strings 

Test and Set Memory Bit 
Execute 

Extract Field 

Exit From Floating Point Interpreter 
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Alphabetical List of Assembly Language Instructions (Continued) 


Hexadecimal 


Operation Code Format Notes 
OFCO 6 
0030 18 
ODCO 6 
02C0 18 
02A0 18 
06CO0 6 
0025 11 
4000 1 
5000 | 
1F00O 2 
OCOA 14 
OC09 14 
0E30 12 
OCOB 14 
0480 6 
0C30 16 
OCOE/ 7 

OCOF 
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Table 3-3. Alphabetical List of Assembly Language Instructions (Continued) 


Mnemonic Hexadecimal 
Operation Code Name Operation Code Format Notes 
XOP Extended Operation 2C00 9 
XOR Exclusive OR 2800 3 
* XORM Exclusive OR Multiple Precision 0026 11 
* XV Extract Value 0C20 16 
Notes: 


1. The instruction is privileged. 


2. When the privileged instruction bit of the status register (bit 7) is set to 1, RIWP and LST return only 
status bits 0 through 5 to the status register. 


3. When the privileged instruction bit of the status register (bit 7) is set to 1, and the effective CRU 
address is greater than > E00, an error interrupt occurs and the instruction ts not executed. 


4. This instruction is not implemented in the TMS9900. 


5. Status bits 0, 1,2, and 4 are set before the operation is performed. 
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3.6 INTERRUPT TRAPS AND ERROR INTERRUPT STATUS BITS 


Figure 3-2 shows the interrupt traps. There are 16 interrupt levels available, several in use by the 
hardware as noted. Other interrupt levels are Heed for device interrupts according to the system 
hardware configuration. 


Interrupt level 2 is defined as the system error interrupt. Eleven conditions can cause a system 
error interrupt. These are mapped by DNOS into crash codes in the range of >60 through >6F. 
These conditions are listed in Figure 3-3. For further details about the error conditions, refer to the 
DNOS Messages and Codes Reference Manual. 
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MA TRAP 












2283148 


Figure 3-2. Interrupt Traps 
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CRU 
BITS (BASE ADDRESS 1FCOq6) 
TIMEOUT 


PRIVOP 


Ww 
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MAPERR 
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CK 
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*990/12 ONLY 
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Figure 3-3. Error Interrupt Status Bits 


2270505-9701 3-31 ' Assembly Language Instructions and Formats 


3.7 COMPUTER STATUS REGISTER 


Figure 3-4 shows the status register of the Model 990 and Business System computers. Table 3-4 
shows which of the bits in the status register are used by which systems. 
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| : } 


O 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
LOGICALLY 
GREATER THAN 


INTERRUPT MASK 
ARITHMETICALLY 


WCS ENABLE 
GREATER THAN 1=ENABLE WRITABLE CONTROL STORE 


Equa. OVERFLOW INTERRUPT ENABLE 
1=ENABLE ERROR INTERRUPT ON ARITHMETIC 
OVERFLOW ERROR 
CARRY MEMORY MANAGEMENT AND PROTECTION ENABLE 
1=ENABLE FLAGS 
MAP FILE SELECT 
OvERFECON O=MAP 0 1=MAP 1 


1=NON~PRIV. MODE 


XOP IN PROGRESS 


2282795 


Figure 3-4. Computer Status Register 
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Table 3-4. Status Register Bit Usage by System 


Bit System 
0-7 990/10, 990/10A, 990/12, Business Systems 300, 600, 800 
8 990/10A, 990/12, Business Systems 300, 600, 800 
9-11 990/12, Business System 800 
12-15 990/10, 990/10A, 990/12, Business Systems 300, 600, 800 
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3.8 WORKSPACE POINTER AND REGISTERS 


The workspace pointer (WP) register contains the address of the first byte in the currently active 
set of workspace registers. A workspace register file occupies 32 contiguous memory bytes in the 
program memory area. The address of the first byte must be even. Figure 3-5 shows the workspace 
pointer and registers. Table 3-5 shows the dedicated workspace registers. 
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WORKSPACE 
ia aaa ADDRESS 


REGISTERS 


we + 00 
WP + 02 
WP + 04 
WP + O06 
WP+ 08 
WP + OA16 
PROCESSOR ADDS WES OCT 
WORKSPACE POINTER WP + OEy6 
(WP) TO THE 
REGISTER NUMBER TO WP + 10, 6 
DERIVE ACTUAL 
REGISTER ADDRESS WP + 1216 
WP + 1446 
WP + 1646 
WP + 1816 
WP + 1A16 
WP + 1C 46 
WP + 1Ey 6 





NOTE: 
ALL. MEMORY WORD ADDRESSES ARE EVEN. 


2282900 
Figure 3-5. Workspace Pointer and Registers 
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Register 


0 (bits 12-15) 


0 (bits 4-7) 


0 (bits 12-15) 
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Table 3-5. 


Contents 


Shift count 
(optional) 


Count field 
(optional) 
Count field 
(optional) 


Count field 
(optional) 


Floating point 
accumulator 


Dedicated Workspace Registers 
Used During 


Shift instructions (SLA, SRA, SRC, SRL, SRAM, SLAM) 


Byte string instructions (990/12 and Business System 
800 only—CRC, CS, MOVS, MVSK, MVSR, POPS, PSHS, 
SEQB, SNEB, TCMB, TMB, TS, TSMB) 


(990/12 and Business System 800 only—INSF, IOF, 
SLAM, SRAM, XF, XV) 


Multiple precision instructions (990/12 and Business 
System 800 only—AM, ANDM, BDC, CNTO, DBC, INSF, 
IOF, LTO, NRM, ORM, RTO, SLAM, SM, SRAM, SWPM, 
XF, XORM, XV) 


Conversion instructions (990/12 and Business System 
800 only—CDI, CRI) 
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Register 


0-1 


0-1 


0-3 


11 


12 (bits 3-14) 
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Contents 


Floating point 
accumulator 


Destination 
Operand 
Floating point 
accumulator 
Return address 


Effective 
address 


CRU base 
address 


Table 3-5. Dedicated Workspace Registers (Continued) 


Used During 


Floating point instructions (990/12 and Business 
System 800 only—AR, CDE, CER, CIR, CRE, CRI, DR, 
LR, MR, NEGR, SR, STR) 


Signed instructions (990/12 and Business System 800 
only—DIVS, MPYS) 


Floating point instructions (990/12 and Business Sys- 
tem 800 only—AD, CDE, CDI, CED, CID, DD, LD, MD, 
NEGD, SD, STD) 


Branch and link (BL) instruction 


Software implemented XOP instruction 


CRU instructions (SBO, SBZ, TB, LDCR,STCR) 
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Register 


13 


14 


15 


Table 3-5. Dedicated Workspace Registers (Continued) 


Contents 


Saved WP 
register 


Saved PC 
register 


Saved ST 
register 


3.9 MACRO LANGUAGE 


Used During 


Context switching (BLWP, RTWP, software XOP, recog- 
nized interrupt, LOAD, RSET) 


Context switching (BLWP, RTWP, software XOP, recog- 
nized interrupt, LOAD, RSET) 


Context switching (BLWP, RTWP, software XOP, recog- 
nized interrupt, LOAD, RSET) 


The elements of macro language are labels, strings, constants, operators, variables, parameters, 
symbols, keywords, and verbs. A macro definition contains statements including macro language 
verbs and model statements. Table 3-6 shows the syntax of the statements containing the macro 
language verbs. Table 3-7 defines the macro variable components and the symbol components. 


2270505-9701 
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Table 3-6. Macro Language Table 


Statement _ Syntax 
MACRO <macro name>...$MACRO...[<parm>][,<parm>]...[<comment>] 
VARIABLE .. SBVAR...<var>[,<var>]...[<comment >] 
ASSIGN .. SASG...< expression >...TO...<var>..[<comment>] <string> 
NAME <label>...SNAME...[<comment>] 
GOTO .. SGOTO...<label>...[<comment>] 
EXIT .. SBEXIT...[<comment >] 
CALL .. SCALL...< macro name>..[<comment>] 
IF . SIF...<expression>...[<comment>] 
ELSE .. DBELSE...[< comment >] 
ENDIF .. bDENDIF...[< comment >] 
END [<label>]...$END...[<comment>] 
SUBSTRING .. SSBSTG...<var>,<expr>,<expr>...TO...<var>..[<comment>] 
Note: 


Use the comment field on the $MACRO statement only if you specify at least one parameter. 
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7 


Macro Variable Components: 


Symbol Components: 
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-< pon 


Ss 
SV 
SA 
SL 
SU 
SG 


Table 3-7. Macro Component Table 


Meaning 


The string component of the variable 
The attribute component of the variable 
The value component of the variable 
The length component of the variable 


The string component of alinked symbol 


_ The value component of alinked symbol 


The attribute component of alinked symbol 

The length component of alinked symbol 

The user attribute component of a linked symbol 
The segment component of alinked symbol 
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3.10 OBJECT CODE FORMAT 


Table 3-8 lists the tag characters and the field values associated with each tag. Unless otherwise 
noted in the table, the size of each field is either four characters (ASCII object format) or four 
binary digits (compressed object format). Variations in this size are noted by an integer value in 
parentheses following the field value description. The tags are listed in groups, where the group 
heading indicates the general function of the tags in that group. 


Table 3-8. Object Record Format and Tags 


Tag Field 1 


Module Definition Tags: 


0 PSEG length 
M DSEG length 
M Blank common length 
M CSEG length 
M CBSEG length 
2270505-9701 . 3-42 


Field 2 Field 3 


Module name (8) — 


$DATA 0000 
$BLANK Common no. 
Common name (6) Common no. 
$CBSEG CBSEG No. 
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Tag 


Table 3-8. Object Record Format and Tags (Continued) 


Field 1 


Entry Point Definition Tags: 


1 


Absolute address 


2 P/R address 
Load Address Tags: 
9 Absolute address 
A P/R address 
S D/R address 
Data Tags: 
B Absolute value 
C P/R address 
T D/R address 
N C/R address 
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Field 2 Field 3 


Common or CBSEG no. — 
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Table 3-8. Object Record Format and Tags (Continued) 


Tag Field 1 . - Field 2 Field 3 


External Definition (DEF) Tags: 


6 Absolute value Symbol (6) — 
5 P/R address Symbol (6) — 


W D/R or C/R address Symbol (6) Common no. 


External Reference (REF) Tags: 


3 P/R chain address Symbol (6) — 
4 Absolute chain address Symbol (6) — 
X D/R or C/R chain address Symbol (6) Common no. 
E Symbol index number Absolute offset — 
Secondary External Reference Tags: 
V P/R chain address Symbol (6) — 
y. Absolute chain address Symbol (6) — 
Z. D/R or C/R chain address Symbol (6) Common no. 
U 0000 Symbol (6) — 
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Table 3-8. Object Record Format and Tags (Continued) 
Tag | Field 1 ro Field 2 Field 3 


Symbol Definition Tags: 


G P/R address Symbol (6) — 
H Absolute value Symbol (6) — 
J D/R or C/R address Symbol (6) Common no. 


Checksum and End-of-Record Tags: 


7 Value — — 
8 Any value — — 
F = = ane 


Load Bias Tag: 

D Absolute address _ — 
Repeat Count Tag (FORTRAN Only): 

R Value Repeat count | — 
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Table 3-8. Object Record Format and Tags (Continued) 
Tag Field 1 Field 2 Field 3 


Program ID (IDT) Tag (Link Editor Only): 

| P/R address Module name (8) — 
CBSEG Reference Tag (COBOL Only): 

Q Record offset CBSEG no. | — 


Notes: 

P/R indicates program relocatable (within a PSEG). 
D/R indicates data relocatable (within a DSEG). 

C/R indicates common relocatable (within a CSEG). 


CBSEG indicates COBOL segment. 


For further information, refer to the Assembly Language Reference Manual. 
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| Program Development 


4.1 INTRODUCTION 

This section outlines steps necessary to develop and execute a program. It also provides infor- 
mation about development tools such as the link editor and debugger. 

4.2 PROGRAM DEVELOPMENT STEPS 


Use the following steps to create, link, install, and execute a program. Commands relating to each 
step appear in parentheses at the end of the step. 


1. Create your source file using the text editor. 


XE 
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2. Compile or assemble your source file using the compiler or the assembler. The compiler 
executes in either background or foreground. 


3. Link your program if necessary. 
XLE 
a. Check errors and investigate all unresolved references. 
b. Relink if necessary. 


XLE 


4. During linking, if you do not specify the FORMAT IMAGE option, you must install your 
overlay, procedure, segment, or task. 


lO, IP, IPS, or IT 
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; : 


5. Establish the appropriate environment of synonyms, logical names, and LUNOs by set- 
ting up command procedures that: 


a. Bid your task in either foreground or background mode. 
b. Restore the environment as it was before your program executed. 


6. Execute your task in either background or foreground mode. 
4.3 LINK EDITOR COMMANDS 


Table 4-1 lists the link editor commands and their syntax statements alphabetically. A brief 
description of the syntax rules follows the command list. 
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Table 4-1. Link Editor Commands 
Command List Notes 


ABSOLUTE 

ADJUST  [n] 

ALLGLOBAL 

ALLOCATE 

AUTO 

COMMON _base,name[,name...,name] 

DATA base 

DUMMY 

END 

ERROR 

FIND [name...,name] 

FORMAT {ASCII/COMPRESSED/IMAGE[,REPLACE]L,priority]} 
GLOBAL [symbol...,symbol] 

INCLUDE [name...,name] See Note 1. 
LIBRARY name[,name...,name] 

LOAD 

MAP {REFS/NO$‘string’[,NO$‘string’....NO$‘string’]} 
NOAUTO 
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Table 4-1. Link Editor Commands (Continued) 
Command List Notes 


NOERROR 

NOLOAD 

NOMAP 

NOPAGE 

NOSYMT 

NOTGLOBAL  [symbol...,symbol] 

PAGE 

PARTIAL 

PHASE /evel,name[,PROGRAM basel][,ID n] See Note 2. 
PROCEDURE name 

PROGRAM _ base 

SEARCH  [name...,name] 

SEGMENT map,name[,PROGRAM base][,!|D n] 
SHARE name,name[,name...,name] | 

SYMT 

TASK [name][,PROGRAM base] 
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Table 4-1. Link Editor Commands (Continued) 


Notes: 


1. If you do not specify a name operand, the object module(s) to be included must immediately 
follow the INCLUDE command in the control stream. : 


2. If you use the PHASE command with the ABSOLUTE command, the PROGRAM base operand 
is required and can be followed by an optional DATA base operand. 


The following syntax rules apply to the link editor commands. 


1. Enter commands by typing in the command name, followed by at least one blank and then 
any operands required. 


2. Enter either the full command name or only the first four characters of the name. This also 
applies to the PROGRAM operand in the PHASE, SEGMENT, and TASK commands. 


3. Separate multiple operands by commas. 
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) } 


4. Place each command on a separate line (record). 


5. Precede comments by a semicolon (;). Place comments on a separate line or after a com- 
mand and its operand(s). 


6. Youcanuse synonyms and/or logical names to specify pathnames. 
7. The notations used in the syntax definitions are as follows: 


a. Enter items in uppercase exactly as shown except for the command names and 
PROGRAM operand, which you can enter in the four-character abbreviated form. 


b. Replace items in lowercase italics with a specific operand of the appropriate type 
indicated. 


c. You may enter items in square brackets ([ ]); you must enter items not enclosed in 
square brackets. 
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d. Youcan enter one of several operands in braces ({ }). The choices are separated by 
slashes (/). | 


e. You can repeat an operand preceding an ellipsis (...) as many times as necessary. 
You must separate the operands with commas. 


For further information, refer to the DNOS Link Editor Manual. 
4.44 DEBUGGER COMMANDS 


_ Table 4-2 lists the SCl commands that are most frequently used in debugging. Table 4-3 lists the 
debugger commands that allow control and trace execution of instructions in a task. 
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Table 4-2. General Debugger Commands 
SCI Command Command Name 


Data Display Commands: 


LB List Breakpoints 

LM List Memory 

LSM List System Memory 

SIR Show Internal Registers 

SP Show Panel 

SV Show Value 

SWR Show Workspace Registers 


Data Modification Commands: 


MIR Modify Internal Registers 
MM Modify Memory 

MSM Modify System Memory 
MWR Modify Workspace Registers 
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Table 4-2. General Debugger Commands (Continued) 


SCI Command 


Breakpoint Commands: 
AB 
DB 
DPB 
PB 


Task Control Commands: 


AT 
HT 
QD 
RT 
XD 
XHT 
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Command Name 


Assign Breakpoint(s) 

Delete Breakpoint(s) 
Delete/Proceed from Breakpoint(s) 
Proceed from Breakpoint 


Activate Task 

Halt Task 

Quit Debug Mode 
Resume Task 

Execute in Debug Mode 
Execute and Halt Task 
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Table 4-2. General Debugger Commands (Continued) 


SCI Command 


Search Commands: 


Pascal Commands: 
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FB 
FW 


ABP 
DBP 
DPBP 
LBP 
LPS 
PBP 
SPS 


Command Name 


Find Byte 
Find Word 


Assign Breakpoint — Pascal 

Delete Breakpoint — Pascal 

Delete and Proceed from Breakpoint — Pascal 
List Breakpoints — Pascal 

List Pascal Stack 

Proceed from Breakpoint — Pascal 

Show Pascal Stack 
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Table 4-3. Debugger Commands for Simulated Mode 


SCI Command 


ASB 
DSB 
LSB 
RST 
ST 


Command Name 


Assign Simulated Breakpoint 
Delete Simulated Breakpoint(s) 
List Simulated Breakpoints 
Resume Simulated Task 
Simulate Task 


For further information, refer to the DNOS Assembly Language Programmer’s Guide. 
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SVC Blocks 





5.1 INTRODUCTION 


This section lists supervisor call (SVC) blocks by hexadecimal opcode and provides a line drawing 
of each call block. These line drawings show the type of information necessary for each call block. 
Applicable system flags, user flags, and operations for each sub-opcode are summarized in var- 
ious tables. Table 5-1 lists the SVCs by hexadecimal opcode. 
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Table 5-1. SVC Opcodes 


SVC # Name 
00 I/O Operations 
Resource-Independent Sub-opcodes: 
00 — Open 
01 — Close 


02 — Close, Write EOF 
03 — Open and Rewind 
04 — Close and Unload 
05 — Read Device Status 
06 — Forward Space 

07 — Backward Space 
09 — Read ASCII 

0B — Write ASCII 

0D — Write EOF 


OE — Rewind 
OF — Unload 
Resource-Specific Sub-opcodes: 
See Table 5-4. 
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Table 5-1. SVC Opcodes (Continued) 


SVC # Name 
01 Wait for I/O 
02 Time Delay 
03 Get Date and Time 
04 End of Task 
06 Suspend Task 
07 Activate Suspended Task 
09 Extend Time Slice 
OA Convert Binary to Decimal 
OB Convert Decimal to Binary 
OC Convert Binary to Hexadecimal 
0D _ Convert Hexadecimal to Binary 
OE Activate Time-Delayed Task 
OF Abort I/O Request by LUNO 
10 Get Common Data Address 
11 Change Task Priority 
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Table 5-1. SVC Opcodes (Continued) 


SVC # Name 
12 Get Memory 
13 Release Memory 
14 Load Overlay 
17 Get Task Bid Parameters 
1B Return Common Data Address 
1C Put Data 
1D Get Data 
1F Scheduled Bid Task 
20 Install Disk Volume 
21 System Log Queue Request 
22 Disk Management 
24 Suspend for Queue Input 
25 Install Task Segment 
26 Install Procedure/Program Segment 
27 Install Overlay 
28 Delete Task 
29 Delete Procedure/Program Segment 
2A Delete Overlay 
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Table 5-1. SVC Opcodes (Continued) 


SVC # Name 

2B Execute Task 

2C Read/Write TSB 

2D Read/Write Task 

2E Self-Identification 

2F Get End Action Status 

31 Map Program Name to ID 

33 Kill Task 

34 Unload Disk Volume 

35 Poll Status of Task 

36 Wait for Any I/O 

37 Assign Program File Space 

38 Initialize New Disk Volume 
& 3B Set Date and Time 

3D Semaphore Operations 


Sub-opcodes: 
00 — Signal 
01 — Wait 
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Table 5-1. 


SVC # 


SE 
SF 
40 


SVC Opcodes (Continued) 


Name 
02 — Test 
03 — Initialize 
04 — Modify 


Reset End Action Status 
Retrieve System Data 
Segment Management 


Sub-opcodes: 

00 — Change Segment 

01 — Create Segment 

02 — Reserve Segment 

03 — Release Segment 

04 — Check Segment Status 

05 — Force Write Segment 

06 — Reserved 

07 — Set/Reset Not Modified 
and Releasable 
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Table 5-1. SVC Opcodes (Continued) 


SVC # 


41 
42 
43 


45 


Name 


09 — Load Segment 

0A — Unload Segment 

OB — Set Exclusive Use of 
a Segment 

OC — Reset Exclusive Use 
of aSegment 


Initiate Event 
Wait for Event 
Name Management 


Sub-opcodes: 

00 — Determine Name’s Value 
02 — Set Name’s Value 

04 — Delete Name 

OF — Restore Name Segment 


Get Encrypted Value 
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Table 5-1. 
SVC # 


46 
47 
48 


49 


4F 
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SVC Opcodes (Continued) 
Name 


Get Decrypted Value 
Log Accounting Entry 
Job Management 


Sub-opcodes: 

01 — Create Job 

02 — Halt Job 

03 — Resume Halted Job 

04 — Change Job Priority 

05 — Map Job Name to Job ID 
06 — Kill Executing Job 

07 — Delete Job 

09 — Get Job Information 


Get Accounting Information 
Return Code Processor 
Post Event 
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5.2 SVC CALL BLOCKS 


The line drawings of the SVC blocks are arranged by hexadecimal opcode and use the following 
notations: 


Notation Meaning 
Greater than sign (>) Identifies hexadecimal values. 
Angle brackets (< >) Enclose items returned to the supervisor call block. 
Reserved Designates a call block field or flag that must be set to 0. 
[Reserved] Designates a call block field that is reserved but may con- 


tain any value. 
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These notations apply to the supervisor call block diagrams used in this manual. The opcode and 
name of the SVC are printed on the top left of each SVC explanation. To the right and on the same 
line, the requirements and attributes of the SVC are printed. Additional lines are provided when 
several requirements and attributes apply. The requirements and attributes are: 


e Align on word boundary 
e Privileged tasks only 
e System tasks only 


e Can be initiated as an event 


The !/O Operations SVC, opcode >00, is common to all I/O operations. SVC >00 contains sub- 
opcodes that are defined for each I/O operation. Some of the I/O operations require extensions 


to the basic SVC >00 block. These sub-opcodes and extensions are discussed in subsequent 
paragraphs. 
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The following line drawings represent the basic supervisor call blocks. For further information, 
refer to the DNOS SVC Reference Manual. 


SVC >00 -- I/O OPERATIONS ALIGN ON WORD BOUNDARY 
7 CAN BE INITIATED AS AN 
EVENT 
DEC HEX 













O 0 

ee 

1 6 [Seeenrces [ar 

ee 

ee 
2279470 


For more information on I/O operations, refer to /O Operations SVC >00 Details in this section. 
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SVC >O1 -- Wait FOR I/O ALIGN ON WORD BOUNDARY 


DEC HEX 






0 O 
2 2 ADDRESS OF BYTE 2 oF I/O CALL BLock 
2279471 


SVC > 02 -- TIME DELAY ALIGN ON WORD BOUNDARY 


TIME DELAY COUNT 


DEC HEX 
0 0 





2 2 





2279455 
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SVC >03 -- GET DATE AND TIME ALIGN ON WORD BOUNDARY 





DEC HEX 
3 
3 
2279738 | | 
SVC > 04 -- END OF TASK 
DEc HEX 
0) 6) >04 
2279462 
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SVC >06 ~- UNCONDITIONAL SUSPEND 
DEC HEX 


ee a 


2279458 


SVC >07 -- ACTIVATE SUSPENDED TASK 


DEC HEX 






2 2 RUN-TIME ID | 


2279459 
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| | 


SVC >09 -- EXTEND TIME SLICE 


DEC HEX 


2279460 


SVC > OA -- CONVERT BINARY TO DECIMAL ASCII 






DEC HEX . : 
ee a ee 
» 2 [Tascinmmiceume | casciioens 
<4 [PD ascitomns | <ascttaen> 
5 [ssscipens | <aseu oer 
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Register 0 contains the value to be converted. 
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SVC > OB -- CONVERT DECIMAL ASCII TO BINARY 






DEC HEX 

ae 
2 2 [recuse | aseoer 
6 4 | ascnper [Asc or 
ss [asco | ascuoer 
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Register 0 receives the converted value. 
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SVC >OC -—- CONVERT BINARY TO HEXADECIMAL ASCII 








DEC HEX 

a 

a <ASCII Diets 
2279718 


Register 0 contains the value to be converted. 


2270505-9701 5-17 SVC Blocks 


SVC >O0OD -- CONVERT HEXADECIMAL TO BINARY 


DEC HEX 







0 0 
2 2 ASCII DIGIT ASCH DIGIT 
4 4 ASCII DIGIT ASCII Dicit | 


2279719 
Register 0 receives the converted value. 


SVC >OE -- ACTIVATE TIME DELAY TASK 








DEC HEX . | 
ot 
2 2 RUN-TIME ID 





2279456 
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SVC Blocks 


Byte 2 Flags 


SVC > OF -- ABORT 1/O PRIVILEGED TASK * 


DEc HEX 











ye O Donotclose 

4 4 ZERO, OR ADDRESS OF TSB 1 ——_ Do not close files and devices 

-_ 0 — Close open files and devices 
2286051 1-7 Reserved 


*Task must be software privileged if aborting I/O in another job. 


SVC >10 -- GET COMMON DATA ADDRESS 
DEC HEX 


The address is returned to register 9. 


2279755 


The size of the area is returned to register 8. 
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SVC >11 -- CHANGE TASK PRIORITY 


DEC HEX 


0 0 S14 | NEw PRIORITY LEVEL 
<OLD PRIORITY LEVEL> 










2279457 
SVC >12 -- GET MEMORY ALIGN ON WORD BOUNDARY 
DEC HEX 
3 
2279724 


Register 9 receives the beginning address of the first beet. 
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SVC >13 -- RELEASE MEMORY ALIGN ON WORD BOUNDARY 


DEC HEX 


ae 


2 2 | RESERVED] 





2279725 


All memory beyond the address in register 9 is released. 
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SVC >14 -- LOAD OVERLAY ALIGN ON WORD BOUNDARY 






DEC HEX 
ee ee 
_ 
Ls 
co 

2279447 

Load Address: 


If 0, use the natural load address. If the nonzero load address differs from the steal load 
address and the overlay is relocatable, then relocation is performed. 


Program File LUNO: | 
If O, use .SSS$SHARED proram file. If >FF, use the same program file as the requesting task. 


Otherwise, specifies LUNO previously assigned to correct program file. 
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SVC >17 -- GET TASK BID PARAMETERS ALIGN ON WORD BOUNDARY 





DEC HEX 
+. oe 
6 roe 
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SVC >1B -- RETURN COMMON DATA ADDRESS 
DEC HEX 
@) 0 >1B 


2279756 
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SVC >1C -- PuT DATA | ALIGN ON WORD BOUNDARY 












DEC HEX , 

ee ee ee 
ee ee 
ee 
e 6 {tResemveo 
es 


2279757 
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SVC >1D -- GET DATA 


a 


Dec HEX 


2286060 


SVC >I1F -- 
Dec HEX 

0 (6) 

2 2 

4 4 

6 6 

8 8 

10 A 

12 Cc 


2286048 
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SCHEDULED BID TASK 


( 


ALIGN ON WORD BOUNDARY 














Hour 






SECOND 











ALIGN ON WORD BOUNDARY . 
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1-7 


2-7 


Byte 2 Flags 


Delete flag 
1 — Delete all messages in the queue 
without return 
O — Return the oldest message and 
delete that message from the queue 
Reserved 

Byte 9 Flags 


Station ID/LUNO 


1 — Station ID and LUNO in bytes 14-15 
0 — Station ID of calling task and system pro- 
gram file 


Job ID flag 


1 —Job ID specified in bytes 16-17 
0 — Same job as calling task 


Reserved 
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SVC > 20 —-- INSTALL DISK VOLUME ALIGN ON WORD BOUNDARY 
PRIVILEGED TASK ONLY 











Dec HEx , 
_ 
2 2 
DiskK DRIVE NAME 
4 4 
6 6 


VOLUME NAME 
12 C | | 


2279714 
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| ) ) 


tems 
a 


SVC > 21 -- SYSTEM LOG ALIGN ON WORD BOUNDARY 











DEC HEX 

ee ee 
ee 
64 [ eirvenasonees 
a 


2279742 
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SVC > 22 -- DISK MANAGEMENT ALIGN ON WORD BOUNDARY 
PRIVILEGED TASK ONLY 








DEC HEX , 
a 
22 
4 4 Disk PDT ADDRESS 
6 6 BLock Size (BYTES) 
8 8 NUMBER OF BLOCKS 
OR 
10 A NUMBER OF ADUs 
12 C : ADU NUMBER 





2279750 
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The return fields after a successful allocation are: 










DEC HEX 

8 8 ADU/BLock BLocKks/ ADU 

10 A NUMBER OF ADUS ALLOCATED 

12 Cc STARTING ADU NUMBER 
2279751 
SVG > 24 -- SUSPEND FOR QUEUE INPUT SYSTEM TASK ONLY 

- Dec HEX 
: : 

2279752 
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ALIGN ON WORD BOUNDARY 
PRIViLEGED TASKS ONLY 


SVC >25 -- INSTALL TASK SEGMENT 



















0 0 
_ 
4 4 
TASK SEGMENT NAME 
10 A 


2286040 


Program File LUNO: 
If 0, use .S$SHARED program 
file. lf FF, use same program file 
as bidding task. 
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5-30 


NOOR WDM =| © 


NO oR WDM =| © 


Byte 12 Flags 


Privileged 

System 

Memory resident 

Delete protected 

Replicatable 

Proc 1 on .S$SHARED 

Proc 20n .S$SHARED 

Special install (used by system) 


Byte 17 Flags 


Overflow 

WCS 

Execute protect 
Software privileged 
Updatable 

Reusable 

Copyable 

Reserved; set to zero 


Change 1 SVC Blocks 


| 








SVC >26 -- INSTALL PROCEDURE/PROGRAM ALIGN ON WORD BOUNDARY 
SEGMENT PRIVILEGED TASKS ONLY 
Dec Hex 
= 
4 4 
PROCEDURE SEGMENT NAME 
10 A 
18 12 RESERVED 





Fuacs 
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Byte 12 Flags 


0 Segment flag 


1 — Program seg 
0 — Procedure seg 


1 For program seg only. May only be 
accessed by system task 
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2 Memory resident 

3 Delete protected 

4 Uses Writable Control Store (procedure 
seg); replicatable (program seg) 

5 Execute protected (procedure seg); not 
sharable (program seg) | 

6 Write protected (procedure seg); reserved 
(program seg) 

7 Special install; set to 0 


Byte 18 Flags 


For procedure seg only. 
For a program seg, byte 18 should be set to 0. 


Reserved 

Writable Control Store 
Execute protect 

Write protect 
Updateable 

Reusable 

Copyable 

Reserved; set to 0 


NOOO f WD =] O 
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SVC > 27 -- INSTALL OVERLAY ALIGN ON WORD BOUNDARY Byte 12 Flags 
PRIVILEGED TASKS ONLY 




















2 2 ROGRAM FILE VERLAY | 
; ‘ [| Precnan Fite LUNG | 3 Delete protect 
4-5 Reserved 
OVERLAY NAME 
a 6 Task/Segment flag 
i ans 1 — Associated seg ID is aprogram segment ID 
im te 0 — Associated seg IDis atask segment ID 
wo ate peclelijetaliiaen (0 
22686042 
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SVC >28 —- DELETE TASK 


ALIGN ON WORD BOUNDARY 
PRIVILEGED TASK ONLY 






DEC HE X 
_ 
2286043 


SVC >29 -- DELETE PROCEDURE/PROGRAM 
SEGMENT 


ALIGN ON WORD BOUNDARY 
PRIVILEGED TASK ONLY 










_ 
2 
e 4 
2286044 
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Byte 4 Flags 


0-6 Reserved 
7 Program file LUNO is open 


Byte 4 Flags 


0-6 Reserved 
7 Program file LUNO is open. 
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Byte 4 Flags 


SVC >2A -- DELETE OVERLAY ALIGN ON WORD BOUNDARY 
PRIVILEGED TASK ONLY 


0-6 Reserved 





Dec HEX 
os 7 Program file LUNO is open 
2 2 PROGRAM FILE LUNO 
2286045 
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SVC > 2B -- EXECUTE TASK ALIGN ON WORD BOUNDARY Byte 3 Flags 







aay nee ee | 
0 — Same job 
44 
os 1 Reserved 
a 2 Reserved 
oo 3 Background 
2286047 4 Terminate calling task 
9 Reserved 
6 Unconditionally suspend task 
7 Suspend calling task until called task terminates 
Station ID: 


If 0, use the same ID as the calling task. If > FF, use no Station ID. 
Program File LUNO: 


If 0, use the .S$SHARED program file. If >FF, use the same program file as the requesting 
task. 
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SVC > 2C -- READ/WRITE TSB ALIGN ON WORD BOUNDARY 
PRIVILEGED TASK ONLY 
DEF HEx 
7 
_ 
4 4 Task Run ID OFFSET INTO TSB 
vo 
Kd 
2286058 
SVC > 2D -- REaD/WRITE TASK ALIGN ON WORD BOUNDARY 
PRIVILEGED TASK ONLY 
Dec HEX 
ake 
- 


36 


38 


2286059 
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BUFFER 


(16 worpbs) 
24 
: 


5-36 


Byte 2-3 Flags 


0-14 Reserved 
15 Set to 1 for write; 
Set to 0 for read. 


Byte 3 Flags 


0 Set to 1 for write; 
Set to 0 for read. 
1 ID flag 


0 — Task run ID in byte 2 
1 — System overlay ID in byte 2 


2-3 Reserved 
4-7 Number of words to be read or written; 
specify 0 to read or write 16 words. 
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SVC > 2E -- SELF-IDENTIFICATION 










DEC HEX 
= 
_ 


2279743 
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SVC > 2F -- GET END ACTION STATUS 


DEC HEX 
O O 
2 2 
A 4 
6 6 
8 8 
2279744 
2270505-9701 





9-38 


ALIGN ON WORD BOUNDARY 










SVC Blocks 


} 


SVC >31 -- MAP PROGRAM NAME TO [ID ALIGN ON WORD BOUNDARY 


DEc 


2286046 
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HEX 


ee oe 
ee 





PROCEDURE, TASK, OR OVERLAY NAME 
OR 
A <PROCEDURE, TASK, OR OVERLAY NAME > 


Cc LUNO OF PROGRAM FILL <ID>or ID 





Byte 2 User Flags 


0-1 Type of segment 


00 — Task 
01 — Procedure 
10 — Overlay 


2 Defines operation 


1 — Return name 
0 — Return ID 


3-6 Reserved 
7 Current state of LUNO 


1 —LUNO opened by this task 
O0—LUNO not opened by this task (0 for 
LUNO >00or >FF) 
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SVC >33 -- KILL TASK | ALIGN ON WORD BOUNDARY 


DEC HEX 







—_ 
_ 
6 . 6 


RESERVED 


2279461 
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SVC > 34 -- UNLOAD DISK VOLUME ALIGN ON WORD BOUNDARY 
PRIVILEGED TASK ONLY 


DEC HEX 
0 0 





2 2 
<Disk DRIVE NAME> 
4 A 
6 6 
VOLUME NAME 
12 Cc 


22d 97S 
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SVC > 35 -- PoLlt STATUS OF TASK 


DEc HEx 


0 6) < RETURN CODE > 

-_ 0 
4 4 STATION ID Run-Time ID 

6 6 RESERVED 





1-7 


2286056 


SVC >36 -- WAIT For Any I/O 


DEC HEX 
0 8) 


2279472 
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Byte 2 Flags 
Set to 1 when byte 4 is station ID; set to 0 
when station ID is station ID of calling 


task 
Reserved 


ALIGN ON WORD BOUNDARY 


< RETURN CODE> 


Change1 SVC Blocks 


: 


SVC >37 -—-- ASSIGN PROGRAM FILE SPACE ALIGN ON WORD BOUNDARY 
PRIVILEGED TASK ONLY 







Dec HEX 

a 

1 

a 

oe 
2279451 
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SVC >38 -- INITIALIZE NEW DISK VOLUME ALIGN ON WORD BOUNDARY 
PRIVILEGED TASK ONLY 
DEx HEx 
2 2 
Disk DRIVE NAME 
4 4 
6 6 
VOLUME NAME 

12 Cc 

18 12 DEFAULT PHYSICAL RECORD SIZE 
2286053 


5-44 


Byte 17 Flags 


Set to 1 

1 — Write track one loader 

0 — Do not write track one loader 
1 — Do not format disk 

0 — Format disk 

Reserved 


Change 1 


SVC Blocks 


SVC >3B -- SET DATE AND TIME ALIGN ON WORD BOUNDARY 
PRIVILEGED TASK ONLY 










DEC HEX 

i 
te PONIO I ii scscsccos 
re 


2279739 
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Byte 2 Sub-Opcodes 







SVC > 3D -- SEMAPHORE ALIGN ON WORD BOUNDARY 
CAN BE INITIATED AS AN 
Dec HEx EVENT 
0 Signal; increment semaphore value 
© 1 Wait; decrement semaphore and wait if negative 
~* 2 Test; returns value of semaphore 
6 8 3 Initialize; initialize semaphore 
4 


Modify 


2286055 


SVC >3E -- RESET END ACTION STATUS 






DEC HEX 

a 
2279745 
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; ) } 


SVC >3F -- RETRIEVE SYSTEM DATA 


DEc 


2286057 


>81 
>82 
>83 
> 84 
>85 
> 86 
>87 
>88 


2270505-9701 


ALIGN ON WORD BOUNDARY 


HEX 







INDEX 












Byte 2 Data Structure Type 


PDT (Physical Device Table) 

TPCS (TILINE Peripheral Device Space) 
CSEG LGLCOM (Log Common Data) 
CSEG NFCLKD (Clock Data) 

CSEG NFDATA (Nucleus Data) 

CSEG NFPTR (System Printers) 


CSEG PMDATA (Program Management Data) 


CSEG NFJOBC (Job Management Data) 


9-47 


Byte 3 Flags 


0 Block format 


1 — Returns one word in bytes 10-11 
0 — Returns data in specified buffer 


1 Address 


1 — Value in bytes 6-7 used as 
indirect address 

0 — Value in bytes 6-7 used as 
offset (relative to 
first byte of structure) 


2-7 Reserved 


Change 1 


SVC Blocks 


SVC > 40 -- SEGMENT MANAGEMENT 


DEc 


2286054 


H 


m 


Xx 


oa AS N oO 


ALIGN ON WORD SOUNDARY 


FLAGS 





















SEGMENT ID ONE 
(INSTALLED OR RUN-TIME ID) 


Byte 2 Sub-Opcodes 

and Applicable Flags 
00 Change segment >FF83 
01 Create segment >F983 
02 Reserve segment > 9803 
03 Release segment > 9803 
04 Check segment status >9C03 

2270505-9701 
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Force write segment >F803 
Set/Reset not modified 

and releasable flags > F803 
Load segment > 9803 
Unload segment > 9803 
Set exclusive use > 9803 
Reset exclusive use > 9803 

Byte 16 Attributes 


1 — For task: privileged; other- 
wise, readable segment 

1 — System segment 

1 — Memory resident 

Reserved 

1 — Replicatable segment 

1 — For task: Proc 1 on 
S$SHARED; otherwise, 
share protected 

1 —Fortask: Proc2on . 
SS$SHARED; otherwise, 
reserved 

Reserved 
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Byte 16 Attributes 


1 — For task: overflow protec- 
tion; otherwise, reserved 

1 —Uses WCS 

1 — Execute protected 

1 — For task: software privi- 
leged; otherwise, write 
protected | 

1 —Updatable segment 

1 — Reusable segment 

1 — Copyable 

Reserved 
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Byte 4-5 Flags 


0 1 —Installed ID 

0 — Run-time ID 

1 — Not modified 

1 — Releasable 

1 — Memory based 

1 — Old segment specified by 
run-time ID 

0 — Old segment specified by 
position in bits 14-15 

5 1—Segment is a task seg- 


& WN — 


ment 
6 1—Verify the load address 
7 1—Use bit 8 
8 1—Set exclusive use 


0 — Reset exclusive use 


9-13 Reserved 
14-15 See bit 4 


SVC Blocks 


SVC > 41 -- INITIATE EVENT ALIGN ON WORD BOUNDARY 






DEC HEX 

ae 

= 

a 

. 
2279735 
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SVC >42 -— WAIT FOR EVENT ALIGN ON WORD BOUNDARY 







DEC HEX 
a 
2 2 
A 4 
<EVENT BITsS> 
6 6 
8 8 
EVENT MASK 
10 A 
2 
2279736 
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SVC > 43 -- NAME MANAGEMENT ALIGN ON WORD BOUNDARY 


Dec 


2286049 


2270505-9701 


HEX 






ADDRESS OF PARAMETER LIST 










SEGMENT ID/< PATHNAME FLAG > 


RESERVED 


00 
02 
04 


N G@ ND 


5-52 


Byte 2 Sub-Opcodes 
Determine name’s value 
Set name’s value 
Delete name 


Byte 3 Flags 


Name type 


1 — Logical name 


0 — Synonym 


Reserved 
Global name 


Reserved 
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SVC > 45 -- GET ENCRYPTED VALUE 


DEC 


2279720 


2270505-9701 


HEX 


5-53 









NUMBER OF BYTES OF DATA 
: BUFFER ADDRESS 
RESERVED 


ALIGN ON WORD BOUNDARY 


< RETURN CODE> 


ENCRYPTION KEY 






SVC Blocks 


SVC > 46 -- GET DECRYPTED VALUE ALIGN ON WORD BOUNDARY 












2 9 
2 2 
ENCRYPTION KEY 
8 8 
: 
2279721 
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SVC > 47 -- LoG ACCOUNTING ENTRY ALIGN ON WORD BOUNDARY 


DEC HEX 
0 0 < RETURN CODE> 
2 2 BUFFER ADDRESS 





i 


2279722 
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SVC>48 -—-JOB MANAGE MENT REQUEST ALIGN ON WORD BOUNDARY 



















DEC HEX |, DEC HEX 
0 O >48 22 {6 TASK STATION ID TASK Proc, Fite LUNO 
6 6 Jos Run ID 28 1c 
8 8 UseR ID (8 CHARACTERS! 
JoBp Name (8 CHarRs) 34 22 
14 E 36 24 
16 10 INITIAL TASK ID JCA SIZE UsER Passworpb (8 CHARACTERS! 
42 2A 
18 12 
Task BID PARAMETERS (4 BYTES) 44 2c 
20 14 
USER ACCOUNT NUMBER (16 CHARACTERS) 
58 3A | | 
2286039 
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Byte 2 Sub-Opcodes 


Create job 

Halt job 

Resume halted job 
Change job priority 
Map name to ID 

Kill job 

Delete job 

Get job information 


9:57 


Byte 4-5 Flags 


0 Use bytes 28-59 for new user ID, 
password, and account 
1 Do not validate request 
2 Batch job 
3-15 Reserved 


SVC Blocks 


SVC > 49 -—-—- GET ACCOUNTING INFORMATION ALIGN ON WORD BOUNDARY 



















DEC HEX 
-_ 
4 4 
<CPU EXECUTION TIME> 
6 6 
8 8 
<NUMBER OF SVCsS ISSUED> 
10 A 
12 Cc 
<NUMBER OF I/O BYTES TRANSFERRED> 

14 EF | 

18 12 


2279723 


RESERVED 
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SVC >AC -—-- RETURN CODE PROCESSING | ALIGN ON WORD BOUNDARY 







DEc HEX 

ee 
2 2 [sean 
rr 
es 
re ee 





2279747 


2270505-9701 5-59 SVC Blocks 


SVC > 4F -- Post EVENT ALIGN ON WORD BOUNDARY 







DEC HEX | : 

ie i ae ee 
ee 
ee 
oe 





2283150 
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9.3 I/O OPERATIONS SVC >00 DETAILS 

SVC >00 contains sub-opcodes that are defined for each I/O operation. 

5.3.1 Basic SVC >00 Call Block Variant 

The basic call block variant for SVC >00 is a 12-byte call block that includes system flags and user 


flags. The following line drawing represents the basic supervisor call block. Table 5-2 lists system 
flag bits and their descriptions. Table 5-3 lists user flag bits and their descriptions. 
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SVC >00 -- I/O OPERATIONS ALIGN ON WORD BOUNDARY 
CAN BE INITIATED AS AN 
EVENT 















DEC + £4UHEX , 

a 
ee a 
ee 
ee 
5 8 [Ream camer came | 
2279470 | 
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Table 5-2. Bit Description for System Flags 


Bit 


4-7 
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Meaning 


Busy 
Error 
End-of-file 
Event key 


Reserved 


SVC Blocks 


Table 5-3. Bit Description for User Flags 
Bit Meaning 


0 Initiate request 


1 Output with reply 
Read with validation 
Key specified flag 
Buffer has write interleaved format 


2 Security access rights requested 

3 Offset enabled (Read by track) 

3 Resolve logical names (Master reaq) 
3-4 Access privileges (Open operations) 


00 — Exclusive write 
01 — Exclusive all 
10 — Shared 

11 — Read only 
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Table 5-3. Bit Description for User Flags (Continued) 


Meaning 


Offset forward (Read by track) 


Lock (Read operations to files) 

Unlock (Write operations to files) 

Do not suspend (Master Read, Read Call Block) 
Transfer inhibit (Read by track) 

Immediate open (for a TPD) 

Do not replace (Open operations to files, Rename 
file operation) 


Extended call block 
Blank adjust 


set event mode (Open operations) 
No retries (Read by track) 
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Table 5-4 lists applicable system flags, user flags, and operations for each sub-opcode. An asterisk 
notation in Table 5-4 in a column for a particular I/O resource indicates which operations are sup- 
ported by that I/O resource. All system and user flags which may be applicable for a particular sub- 
opcode are shown in the table. The applicable system and user flags for a particular sub-opcode 
are a function of the 1/O resource in use. In most cases, an understanding of the bit descriptions 
for the system and user flags (Tables 5-2 and 5-3) is sufficient to determine which flags apply fora 
specific I/O resource. Refer to the DNOS Supervisor Call (SVC) Reference Manual for further 
information. 
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; ; 


Table 5-4. Applicable Operations for I/O Resources 


DESCRIPTION SYSTEM USER 
FLAGS , FLAGS 
a 


wn 
poof ore fet Efe ffs] PP 
























a 
a 


SUB-OPCODE 
EL REC FILE 
EQ FILE 
ASTER/SLAVE CHAN 
YMMETRIC CHAN 
ARD READER 
ASSETTE 
IRECT DISK 

LINE PRINTER 
AG TAPE 
11 VOT 
40 OR 931 VDT 


= 


= 


w OF oOo; 0 e nT 

















por} cose Cie tt | fo] TTT 
voz] cuose, warre cor tote] | fot TTT TT edd ve dee fe ee fe 
porenanorewino fet ET fet Ts tetst Pepe dete Peed fe fe |e fe de fs 
pea] ctoseanpumtoan eT Tet EE ET EE Ede ede fe ed fe 
|ureancevice starus fot | fot ET TE eee ee ef 
post nanruccuanacrenistics | Fols| | Fol Jet tT EET eee Ta 
08 [EAD POR ee ee 
bE UReMO Te eas EVN CHNACTN ee PO eee Te te pee 
poe | eenwAneeysees ee Oe a eee 
ro7} sackwano space tot tet fol TP TE EE ee Ee ed 
po7| issue restore rooise ott tT fot PT EE EE TE EE 
08 pols{ T fof TET TT Tee a ee et 
poof reavasc ot fet sfot TTT ts] tebe dete Pee ed ee 
poof neanovacy eo TT oT TTT TTT Te 
Boe ska ee ee eases vee eee Eee 
BR a as Pe eee 
FE Ek a 
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Table 5-4. Applicable Operations for I/O Resources (Continued) 


DESCRIPTION SYSTEM USER 
FLAGS FLAGS 
u 









SUB-OPCODE 
REL REC FILE 
SEQ FILE 
MASTER/SLAVE CHAN 
SYMMETRIC CHAN 
CARD READER 
CASSETTE 
DIRECT DISK 
LINE PRINTER 
MAG TAPE 
733 ASR 
911 vor 
940 OR 931 VDT 


4 










beef were Pe CCCP 
poaf svumerme wre eT TET TT TTT TT er 
poof were ey teen eT eT TT 
poof wereomesr eT Te TTT PT TT PT 
poof were eor eT TT 
i i eens oe eee 
peef newer TET TT TT 
poc[ sronesesiorens eT eT TTT TTT Te er TTT 
Perf omens eT eT ET TTT 
Sf a ee nee ea 
1 i ia Onna e ano eee eee ee see 
prof “waive ontereo secron Pe TT ToT TTT ET TET TT eT TT TT 
pii[ woorrv access rmwneses Pes] T Tel T reteT PT PPT TT TTT TT 
suf rexocccereo scorn Pe TT ef TTT TTT TTT TT TTT 
af orevexreno eT Te Tee TT PPT PTT TT TT 
59 ABCA cM a 





2285057 (2/3) 


2270505-9701 5-68 SVC Blocks 


Table 5-4. Applicable Operations for I/O Resources (Continued) 




















z 
t 
Zz 
bole F 
ul = [a] 
4) 1218ls) iets > 
a et Jalelayulele ; 
So wu fC perc Hig |Z ye a 
a) DESCRIPTION SYSTEM USER Of ataepeye Tec «|% oye 
O FLAGS FLAGS wi=tupuje por ital sg wl ale 
° ePuefes eto tale a <]>]0 
o ufsapjol2] sic julelz{eto| =} -jo 
ss) =fwfwfS<]r+fe} elo yo Spay mo} -Je 
uw xfoel_ur rE] unjopPosyoy;v4upyepyrirfpafoa 
Sef ecommerce PTT] PTT TTI PIII tii tl 
prof master reat et et st EE et TT 
pial READ CALL BLOCK rot] tT fet Tc TT sy Et et 
ai) RoE RRR eRe SEER RES RERSE 
mic] REDIRECT ASSIGN LuNO HRs eRe SERCO RR ARR SeREA 
pao | OPEN RANDOM ots] T fol | fetets]| Tee TET TE TE EE TE EE TTT 
pat | READ GREATER otet ET polst Tt ts} Tht TT TE et EE EE TE TT 
paz | READ BY KEY ols] Tort] TE ls? Tet Ett Ea eT 
READ CURRENT pots ToT Tt ts] Eee ET 
pag | READ GREATER OR EQUAL pole) Tet TT sy PT hE EE EE EE 
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pao | DELETE CURRENT pode oot ee eee) pet et es 





2285057'(3/3) 


2270505-9701 5-69 SVC Blocks 


Table 5-4. Applicable Operations for I/O Resources (Continued) 


DESCRIPTION 


pineal 


2285270 


REL REC FILE 
SEQ FILE 
MASTER/SLAVE CHAN 
SYMMETRIC CHAN 
CARD READER 
CASSETTE 
DIRECT DISK 

LINE PRINTER 
MAG TAPE 
733 ASR 
911 VDT 
940 OR 931 VDT 


uJ 
Qa 
ie) 
18) 
a 
ie] 
| 
a 
2 
1) 


Vv 





uw 
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Table 5-5. Utility Flags 


Bit Description 
0 File created by assign 
1,2 File Usage Flags 


OO—No special usage 
01—Directory file 
10—Program file 
11—Image file 


3,4 LUNO scope 


0O0—Task local 
01—Job local 
10—Global 
11—Shared 

5 Autogenerate LUNO 


6 Autocreate file 
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DEc HEX 
O @) 
2 2 
4 4 
6 6 
8 8 
10 A 
12 Cc 
14 E 
16 10 

2286050 

2279469 


SVC >00 -- I/O OPERATIONS 


(UTILITY SUB-OPCODES) 











RESERVED 


Key DEF. Buock ApprR/DEF. PHys. REc. SIZE 


DEc 


18 


20 


22 


24 


26 


28 


30 


32 


34 


ALIGN ON WORD BOUNDARY 
CAN BE INITIATED AS AN 
EVENT 


HEX 
12 


1A 


1c 


1E 


20 


22 








DEFINED LOGICAL RECORD LENGTH 





DEFINED PHYSICAL RECORD LENGTH 
PATHNAME ADDRESS 


RESERVED 


INITIAL FILE ALLOCATION 


SECONDARY FILE ALLOCATION 


Table 5-5 lists utility flag bits and their descriptions. Table 5-6 lists applicable utility flags and oper- 
ations foreach SVC >00 sub-opcode. 


2270505-9701 


5-72 
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Table 5-5. Utility Flags 


Bit Description 
0 File created by assign 
1,2 File Usage Flags 


OO—No special usage 
01—Directory file 
10—Program file 
11—Image file 


3,4 LUNO scope 


0O— Task local 
01—Job local 
10—Global 
11—Shared 

5 Autogenerate LUNO 


6 Autocreate file 
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SVC >00 -- I/O OPERATIONS ALIGN ON WORD BOUNDARY 



















= CAN BE INITIATED AS AN 
(UTILITY SUB-OPCODES) cae 

* DEc HEX DEc HEX 

2 2 LUNO 20 14 DEFINED PHYSICAL RECORD LENGTH 

RESERVED 
8 8 26 1A 
RESERVED 
10 A 28 1c 
INITIAL FILE ALLOCATION 
12 Cc KEY DEF. BLockK ApbR/DEF. PuHys. REc. SIZE 30 1E 
SECONDARY FILE ALLOCATION 

2286050 


2279469 


Table 5-5 lists utility flag bits and their descriptions. Table 5-6 lists applicable utility flags and oper- 
ations foreach SVC >00 sub-opcode. 
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5.3.2 Extensions of the Basic SVC >00 Call Block 

Some sub-opcodes of the I/O Operations SVC >00 require an extension to the basic supervisor 
call block. These extensions, represented by line drawings, are discussed in the following 
paragraphs. 


5.3.2.1. I/O Utility SVC Block Extension. The sub-opcodes of the I/O Operations SVC >00 that 
perform I/O utility functions such as support device 1/O, file I/O, and interprocess communication, 
require an extension to the basic SVC block. The following SVC block applies to all utility func- 
tions except creating and deleting IPC channels. 


a 
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Table 5-5. Utility Flags (Continued) 


Bit 


10 


11, 12 


13 


Description 


Parameters present 

Valid logical record length 
Temporary file 

Immediate write-to-disk file 


Data format 


00— Normal record image 
01—Blank suppressed 
10— Reserved 
11—Reserved 


Allocation may grow 
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Table 5-5. 


Bit 


14,15 


Utility Flags (Continued) 
Description 


File type 


00— Reserved 
01—Sequential file 
10— Relative record file 
11— Key indexed file 


5-75 SVC Blocks 


Table 5-6. 1/O Utility Functions 









DESCRIPTION UTILITY FLAGS 


DEVICE 

i1PC CHAN 
REL REC FILE 
SEQ FILE 


SUB -OPCODE 


Vv 
wo 


CREATE FILE 


Vv 
o 
o 







BERBERS Sere ere 
L 2 ew » wo > 
See SRE 
anes ease eeeaee 
Ppa ale CAE oes Mie cfs esd sees [ou 1) 
SS RR eRe SRE Ree 
le pe el Se ee pe ay ey 
SERERUSRERRESSEECESE 
, ¥, , ¥y, y s, 
veiry Pree oF OEICE Na 70 
A ‘a Z f) /) a g 
ADD ALIAS a een 
ore aL ioe 
Pt 


ASSIGN LUNO 
>92 DELETE FILE 
>93 RELEASE LUNO 
>95 RENAME FILE 
>96 REMOVE FILE OR CHANNEL PROTECTION 
>97 WRITE PROTECT FILE OR CHANNEL 


>98 DELETE PROTECT FILE OR CHANNEL 


nO SS 
eS 


V 


Vv Vv 
ofwo 
> o 


9B 





>9C DEFINE WRITE MODE 


NOTES; 
IF A UTILITY FLAG DOES NOT APPLY, SET TO ZERO 

BITS 8-15 APPLY ONLY _IF BIT 6=1 AND IF THE FILE DOES NOT ALREADY EXIST, IF THE FILE ALREADY EXISTS, 
BITS 1 AND 2, AND 11 THROUGH 15 ARE SET BY THE SYSTEM, 

, 

GF THESE BITS ARE SET BY THE SYSTEM, 


2285058 
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5.3.2.2 Key Indexed File Currency SVC Block Extension. The key indexed file resource-specific 
operations use a single-word extension to the basic supervisor call block, as follows: 


DEC HEX | 


2279648 


The currency block address is the word boundary address of a block containing a key that speci- 
fies the record on which the operation is to be performed. The currency block also contains the 
address of an areain which file management returns information, enabling access to the record by 
commands that do not supply a key. The structure of the currency block is: 
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DEC HEX 









<INF. CODE>PK LENGTH 


a 
7 oe ee 
4 4 


< CURRENCY INFORMATION > 
18 12 


The key or partial key for the operation is in a block or buffer. The address of the block is placed in 
the currency block. 


2279649 


All resource-specific operations except Open Random and Unlock return an informative code in 
byte 0 of the currency block. The informative code is acode that gives the status of an operation. 


5.3.2.3 IPC Channel Utility SVC Block Extensions. To create an IPC channel, a program exe- 


cutes an I/O Operations SVC with sub-opcode >9D. This is the extended supervisor call block for 
this operation: 
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} } 


SVC > 00 -- I/O OPERATIONS 
(UTILITY SUB-OPCODE > 9D) 


Dec HEX 


te) 0 
2 2 
4 4 
6 6 
12 Cc 
14 E 
16 10 
18 12 
20 14 
22 16 
24 18 
34 22 


2286052 
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ALIGN ON WORD BOUNDARY 










RESERVED 


RESERVED 


















CAN SE INITIATED AS AN EVENT 


5-79 


0-1 


© PP 


Byte 5 User Flags 


Channel scope flag 


00 — Task-local scope 
01 — Job-local scope 
10 — Global scope 


Shared channel 
Channel type flag 


1 — Symmetric 
0 — Master/slave 


Owner task processes Assign LUNO 
operations (Master/slave only) 
Owner task processes Abort |/O 
operation (Master/slave only) 
Owner task processes all I/O utility 
operations (Master/slave only) 
Reserved 


Change 1 SVC Blocks 


To delete an IPC channel, a program executes an !/O Operations SVC with sub-opcode >9E. This 
is the extended supervisor call block for this operaton: 










SVC >00 -- I/O OPERATION ALIGN ON WORD BOUNDARY 
UTILITY SUB~OPCODE >9E_) CAN BE INITIATED AS AN EVENT 
DEc HEX | 
os 
a 
4 4 
RESERVED 

20 14 
24 18 





RESERVED 
| 34 22 - 
2279682 , 
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5.3.2.4 Terminal Devices SVC Block Extensions. Most of the TPD, 733 ASR, 911, 931, and 940 
VDT resource-specific 1/0 operations use an extended SVC block. The sub-opcodes for the 
resource-independent operations apply, but the operations are modified by the states of flags in 
the extended user flags field. 


The extended call flag in the user flag field (byte 5) of the SVC block must be set to one for 
resource-specific I/O operations. Otherwise, the system does not use the extensions to the SVC 
block. These flags in the user flag field apply to resource-specific I/O operations: 





2279488 


1 Reply flag. Set as follows: 


1 — Write with Reply, Remote Get Event Character, or Read with Validation 
0 — All other operations 


6 Extended call flag. Set as follows: 
1 — Extended call block (required for resource-specific I/O) 
0 — Basic supervisor call block (used for resource-independent) 
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This is the extension to the basic SVC block for TPD and 733 ASR operations: 






DEC HEX | 





2279510 


These are the extended user flags for TPD operations: 





2283152 
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These are the extended user flags for 733 ASR operations: 


eee See eee 





2279511 


The following is the extension to the basic SVC block for 911, 931, and 940 VDT operations: 







Dec Hex 
20 14 


FieLD BEGINNING Row COLUMN , 
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These are the extended user flags for 911, 931, and 940 VDT operations: 


LORS RMe Re 





2279490 


The following lists the flags and the I/O operations in which the user-extended flags are effective: 


Used in 
Bit | Definition Operations 
0 Field start position All 
1 intensity All 
2 Blink cursor Read ASCII 
3 Graphics Read/Write 
4 Eight-bit ASCII Read/Write Direct 
5 Task edit Read 
6 Beep Read/Write 
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) j 


Used in 


Bit Definition Operations 
7 Right boundary | Read 
8 Cursor position within a read field Read 
9 Fill character Read 
10 Do not initialize field Read 
11 Return on termination character Read 
12 No echo Read 
13 Character validation Read 
14 Validation error mode Read 
15 Warning beep Read 


5.3.2.5 Master Read SVC Block Extension. The Master Read operation returns information from 
the supervisor call block, preceded by a header that contains information about the calling task. 
The master task supplies data in a buffer when processing a read operation requested by a slave 
task, except when zero characters are to be returned to the slave task. The data structure consist- 
ing of the header, the call block contents, and any required buffer is called the master read buffer 
(MRB). 
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Because the SVC block within the MRB varies according to the requested operation and the 
default type, the MRB has several variations. The following block shows the contents of the MRB: 


MASTER READ BUFFER 





Dec 

0 

HEADER 
8 
10 Basic I/O BLock 
OR 
Aport I/O BLock 

a6 (ABORT BLock 2 wORDS SHORTER) 
22 16 


EXTENDED I/O BLock 


(OPTIONAL ) 
2283154 44 2c | | 
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The following line drawings represent the contents of each component of the MRB. A ee zcHeMon 
of the content of specific bytes is included. 


CALLING TASK HEADER 











DEC HEX . 
_ 
2 2 CALL BLOcK ADDRESS 
4 4 TASK STATUS BLOCK ADDRESS 
a 
se 
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The calling task header of the MRB contains this information: 


Byte 


0-1 
2-3 
4-5 


6-7 


8-9 
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Contents 
System security information. 
Call block address. Address of the supervisor call block in the slave task. 
Task status block address. Address of the task status block of the slave task. 


Job status block address. Address of the job status block for the job to which the 
slave task belongs. 


Security information. 
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Basic 1/O BLocK 








2283156 
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The basic I/O block of the MRB contains this information: 


Byte Contents 

10 Opcode, >00. 

11 Return code. The master task may return 0 when the operation completes satis- 
factorily. The task may return an error code when the operation completes in 
error. 

12 Sub-opcode for desired operation. This field contains >91 for an assign LUNO 
operation. 

13 Logical unit number (LUNO). 

14 System flags. DNOS sets the busy flag (bit 0) before returning the call block to 
the master task. | 

15 User flags. You can set these flags for utility operations. The flags for the oper- 
ations that use this field are specified and described in the paragraph on each 
operation. 
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} | 


Byte Contents 

16-17 Data buffer offset. Not used (reserved) for an assign LUNO operation. 
18-19 Read character count. Not used (reserved) for an assign LUNO operation. 
20-21 Write character count. Not used (reserved) for an assign LUNO operation. 


Aport I/O BLocKk 


2283157 
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10 





5-91 SVC Blocks 


The abort I/O block of the MRB contains this information: 


Byte 
10 


11 


12 


13 
14-15 
16-17 
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Contents 
Opcode, >OF. 


Return code. The master task may return 0 when the operation completes satis- 
factorily. The task may return an error code when the operation completes in 
error. 

User flags. Set as follows: 

0 Do not close flag. 


1 — Do not close the LUNO if the task aborts. 
0 — Close the LUNO if the task aborts. 


1-7 Reserved. 
Logical unit number (LUNO). 


Aborting TSB address or O if task is aborting its own I/O. 
Aborting JSB address or 0 if task is aborting its own I/O. 
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EXTENDED I/O BLockK 


2286061 


22 


24 


26 


30 


32 


34 


36 


38 


40 
42 


44 


1A 


1C 


1E 


20 


22 


24 


26 


2A 


2C 












PATHNAME OFFSET 
PARAMETER OFFSET 
RESERVED 


INITIAL FILE ALLOCATION 









SECONDARY FILE ALLOCATION 
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SVC Blocks 


The MRB contains the following: 


Byte 


15 


16-17 
18-19 
20-21 
22-23 
24-25 


26-27 
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Contents 
User flags. You can set these flags for utility operations. The flags for those oper- 
ations that use this field are specified and described in the paragraph pertaining 
to each operation. 
Data buffer offset. Not used (reserved) for an assign LUNO operation. 
Read character count. Not used (reserved) for an assign LUNO operation. 
Write character count. Not used (reserved) for an assign LUNO operation. 
Reserved. . 
Reserved. 
Utility flags. You can set.these flags for utility operations. The flags for each 


operation are specified and described in the paragraph pertaining to each 
operation. 
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Byte 
28-29 
30-31 


32-33 


34-35 


36-37 
38-41 
42-45 
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Contents 
Logical record length. Applies to Create peiauens: 
Physical record length. Applies to Create operations. 
Pathname offset. For all operations except Release LUNO, contains the relative 
address of a buffer that contains the pathname. The address is relative to byte 0 


of the MRB. The format of the pathname buffer is: 


0 — Length n of pathname in bytes 
1-n — Pathname 


Parameter offset. Address of the parameter buffer relative to byte 0 of the MRB. 
The parameters are logical name parameters, in the format described in the 
Name Management SVC description. 

Reserved. 

Initial file allocation. Applies to a Create operation. 


Secondary file allocation. Applies to a Create operation for an expandable file. 
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KENT O4 : 


ASCII Character Codes 





Character 
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NUL 
SOH 
STX 

ETX 

EOT 
ENQ 
ACK 


Table 6-1. 


ASCII 
(Hexadecimal) 


00 
01 
02 
03 
04 
05 
06 


ASCII Character Codes 


6-1 


ASCII 
Character (Hexadecimal) 
BEL 07 
BS 08 
HT 09 
LF OA 
VT OB 
FF 0C 
CR OD 


ASCII Character Codes 


Character 
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SO 
S| 
DLE 
DC1 


DC2 


DC3 
DC4 
NAK 
SYN 
ETB 
CAN 
EM 

SUB 


Table 6-1. 


ASCII Character Codes (Continued) 


ASCII 
(Hexadecimal) 


OE 
OF 
10 
11 
12 
13 


6-2 


Character 


US 
Space 


# 
$ 
“% 
& 
( 
) 


+ 


ASCII 
(Hexadecimal) 


ASCII Character Codes 


Table 6-1. ASCII Character Codes (Continued) 


ASCII ~ ASCII 
Character (Hexadecimal) Character (Hexadecimal) 
0 30 A 41 
| 31 B 42 
2 32 C 43 
3 33 D 44 
4 34 E 45 
5 35 F 46 
6 36 G 47 
7 37 H 48 
8 38 | 49 
9 39 J 4A 
3A K 4B 
3B L 4C 
< 3C M 4D 
= 3D N 4E 
> 3E O 4F 
? 3F P 50 
@ 40 Q 54 
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Table 6-1. ASCII Character Codes (Continued) 


_ ASCII ASCIl 
Character (Hexadecimal) Character (Hexadecimal) 
R 52 Cc 63 
S 53 d 64 
T 54 e 65 
U 55 f 66 
V 56 g 67 
W 57 h 68 
X 58 | 69 
Y 59 j 6A 
Z 5A kK 6B 
[ 5B | 6C 
\ 5C m 6D 
] 5D n 6E 
mn 5E O 6F 
ae 5F p 70 
60 q 71 
a 61 r 72 
b 62 S 73 
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Character 
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—-~aAN< XS < co 


DEL 


Table 6-1. ASCII Character Codes (Continued) 


ASCII 
(Hexadecimal) 


6-5/6-6 


Character 


ASCII 
(Hexadecimal) 


ASCI!l Character Codes 


7 


Job and Task States 





Table 7-1. Job State Codes 


Code Job State 
01 | Being created 
02 | Executable state 
03 Halted 
04 | Terminating 
05 JCA being expanded 
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Code 
(Hexadecimal) 


00 
01 
02 
03 
04 
05 
06 
07 


Table 7-2. Task State Codes 


Significance 


In ready state 

Awaiting memory 

Job in anonexecutable state 

Task being loaded into memory 
Terminated 

In time delay 

Unconditionally sudsnded 
Awaiting Ten X processor completion 
Suspended for I/O 

Suspended for aborted I/O 

Awaiting overlay load services 
Awaiting co-routine activation 
Awaiting completion of initiated I/O 
Awaiting system semaphore 
Awaiting scheduled task bid 
Awaiting install volume completion 
Awaiting disk management services 
Awaiting queue input 


7-2 Change 1 


Job and Task States 
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Code 
(Hexadecimal) 


25 
26 
2/ 
28 
29 
2A 
2B 
2D 


Table 7-2. Task State Codes (Continued) 


Significance 


Awaiting task installation 

Awaiting procedure installation 

Awaiting overlay installation 

Awaiting completion of task deletion 
Awaiting completion of procedure deletion 
Awaiting completion of overlay deletion 
Suspended by Bid Task SVC 

Awaiting read/write task completion 
Awaiting system table area 

Awaiting map program name to |D completion 
Awaiting unload volume completion 
Awaiting any I/O 

Awaiting assignment of program file space 
Awaiting initialize new volume completion 
Suspended by Semaphore SVC 

Awaiting segment management services 
Awaiting event completion 
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Table 7-2. Task State Codes (Continued) 


Code 
(Hexadecimal) Significance 
43 Awaiting name management services 
48 Awaiting job management services 
4A Awaiting forced swap completion 
4C Awaiting return code processing completion 
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Appendix A 
Keycap Cross-Reference 


Generic keycap names that apply to all terminals are used for keys on keyboards throughout this 
manual. This appendix contains specific keyboard information to help you identify individual keys 
on any supported terminal. For instance, every terminal has an Attention key, but not all Attention 
keys look alike or have the same position on the keyboard. You can use the terminal information in 
this appendix to find the Attention key on any terminal. 


The terminals supported are the 931 VDT, 911 VDT, 915 VDT, 940 EVT, the Business System 
terminal, and hard-copy terminals (including teleprinter devices). The 820 KSR has been used as a 
typical hard-copy terminal. The 915 VDT keyboard information is the same as that for the 911 VDT 
except where noted in the tables. 


Appendix A contains three tables and keyboard drawings of the supported terminals. 
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Table A-7 lists the generic keycap names alphabetically and provides illustrations of the 
corresponding keycaps on each of the currently supported keyboards. When you need to press 
two keys to obtain a function, both keys are shown in the table. For example, on the 940 EVT the 
Attention key function is activated by pressing and holding down the Shift key while pressing the 
key labeled PREV FORM NEXT. Table A-1 shows the generic keycap name as Attention, and a 
corresponding illustration shows a key labeled SHIFT above a key named PREV FORM NEXT. 


Function keys, such as F1, F2, and so on, are considered to be already generic and do not need 
further definition. However, a function key becomes generic when it does not appear on a certain 
keyboard but has an alternate key sequence. For that reason, the function keys are included in the 
table. 


Multiple key sequences and simultaneous keystrokes can also be described in generic keycap 
names that are applicable to all terminals. For example, you use a multiple key sequence and 
simultaneous keystrokes with the log-on function. You log on by pressing the Attention key, then 
holding down the Shift key while you press the exclamation (!) key. The same information in atable 
appears as Attention/(Shift)!. 
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Table A-2 shows some frequently used multiple key sequences. 


Table A-3 lists the generic names for 911 keycap designations used in previous manuals. You can 
use this table to translate existing documentation into generic keycap documentation. 


Figures A-1 through A-5 show diagrams of the 911 VDT, 915 VDT, 940 EVT, 931 VDT, and Business 
System terminal, respectively. Figure A-6 shows a diagram of the 820 KSR. 
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Table A-1. Generic Keycap Names 


Business 
911 940 931 820' 
Generic Name System a | 2 
crew, Ee Terminal KSR 


Control 


CONTROL | ie =] a 
a | | ms. 

ie CEL 

rian CHaR 


DEL 
HAR 





a 





Notes: 


"The 820 KSR terminal has been used as a typical hard- 
copy terminal with the TPD Device Service Routine (DSR). 
Keys on other TPD devices may be mise or have 
different functions. 


70n a 915 VDT the Command Key has the label F9 and the 
Attention Key has the label F10. 


2284734 (2/14) 


| Keycap Cross-Reference 


A-4 
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Table A-1. Generic Keycap Names (Continued) 


Generic Name 911 940 931 Business 
= ad snd ea 


H] 





ol 





EY 
(| 
a 





Notes: 


‘The 820 KSR terminal has been used as a typical hard- 


copy terminal with the TPD Device Service Routine (DSR). 
Keys on other TPD devices may be missing or have 
different functions. 
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Table A-1. Generic Keycap Names (Continued) 





Notes: 


‘The 820 KSR terminal has been used as a typical hard- 


copy terminal with the TPD Device Service Routine (DSR). 


Keys on other TPD devices may be missing or have 
different functions. 
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A-6 
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Keycap Cross-Reference 


Table A-1. Generic Keycap Names (Continued) 


Business 
2 911 940 931 
Generic Name System 
cenenename| oo |e | VDT Terminal 
COMTROL Fil - SHIFT 





Notes: 


"The 820 KSR terminal has been used as a typical hard- 
copy terminal with the TPD Device Service Routine (DSR). 
Keys on other TPD devices may be missing or have 
different functions. 
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Keycap Cross-Reference 
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Table A-1. Generic Keycap Names (Continued) 


Business 
911 940 931 820' 
Generic Name System 
ae Oa HE Terminal 
= — ee 
; CHAR 


Next 
Character 


Previous 
Character 





Notes: 


"The 820 KSR terminal has been used as a typical hard- 
copy terminal with the TPD Device Service Routine (DSR). 
Keys on other TPD devices may be missing or have 
different functions. 
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Keycap Cross-Reference 
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Table A-1. Generic Keycap Names (Continued) 


Business 
Generic Name System 
Terminal 
_ 


Upperoase 
Lock 





Notes: 
"The 820 KSR terminal has been used as a typical hard- 
copy terminal with the TPD Device Service Routine (DSR). 


Keys on other TPD devices may be missing or have 
different functions. 


“The keyboard is typamatic, and no repeat key is needed. 
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A-9 
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Table A-2. Frequently Used Key Sequences 


Function 


Log-on 
Hard-break 
Hold 
Resume 
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Key Sequence 


Attention/(Shift)! 
Attention/(Control)x 
Attention 

Any key 


Keycap Cross-Reference 


Table A-3. 911 Keycap Name Equivalents 


911 Phrase 


Blank gray 
Blank orange 
Down arrow 
Escape 

Left arrow 
Right arrow 
Up arrow 
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Generic Name 


Initialize Input 
Attention 

Next Line 

Exit 

Previous Character 
Next Character 
Previous Line 


Keycap Cross-Reference 


y, SORSEERIERSES, 


[- I 18 OIG Gi OiG Gea ta 


IETS ONG Ce) Cs |G) ale eee 
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Figure A-1. 911 VDT Standard Keyboard Layout 
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| FUNCTION 
KEYS STATUS LEDs 
a a_e ee 
: ea On. 35 =O 
Pe IDLE EXEC TEST COMM 
O O OO O 
ERR MODE 0DSO1 DSO2 
[7H (8H (9) 
SE, 













NUMERIC 
KEY PAD 





CURSOR CONTROL 
AND EDIT KEYS 





DATA ENTRY 
KEYS 
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Figure A-2. 915 VDT Standard Keyboard Layout 
2270505-9701 A-13 Keycap Cross-Reference 





ET DISPLAY 
STATUS aca ON/OFF R PEC KEY MARGIN HERE MARGIN 
DEL TABS TABS LINE BREN SCROLL BRIGHT DIM CHAR click MaBRIN HERE peser CONFIGURE LEFT RIGHT RELEASE 





UPPER 
CASE 


‘ DTI. POLI, PEO, P208005" 
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Figure A-3. 940 EVT Standard Keyboard Layout 
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} ) ) 











Bios 
FIELD F 
i 









\ 





sisi 


< 
io 
GEE 
G \__ A 
jaa 
Ps: Wore 








Zion 
Sisio 


pron 


Cl 
a 





2284734 (12/14) 


Figure A-4. 931 VDT Standard Keyboard Layout 
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Figure A-5. Business System Terminal Standard Keyboard Layout 
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| 
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Figure A-6. 820 KSR Standard Keyboard Layout 
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/ 


Alphabetical Index. 


Introduction 





HOW TO USE INDEX 


The index, table of contents, list of illustrations, and list of tables are used in conjunction to ob- 
tain the location of the desired subject. Once the subject or topic has been located in the index, 
use the appropriate paragraph number, figure number, or table number to obtain the corre- 
sponding page number from the table of contents, list of illustrations, or list of tables. 


INDEX ENTRIES 


The following index lists key words and concepts from the subject material of the manual together 
with the area(s) in the manual that supply major coverage of the listed concept. The numbers along 
the right side of the listing reference the following manual areas: 


e sections — Reference to Sections of the manual appear as ‘‘Sections x” with the sym- 
bol x representing any numeric quantity. 
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° Appendixes — Reference to Appendixes of the manual appear as ‘“‘Appendix y” with the 
symbol y representing any capital letter. 


e Paragraphs — Reference to paragraphs of the manual appear as a series of 
alphanumeric or numeric characters punctuated with decimal points. Only the first 
character of the string may be a letter; all subsequent characters are numbers. The first 
character refers to the section or appendix of the manual in which the paragraph may be 
found. 


e Tables — References to tables in the manual are represented by the capital letter T 
followed immediately by another alphanumeric character (representing the section or 
appendix of the manual containing the table). The second character is followed by a 
dash (-) and a number. | 


Tx-yy 
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} | 


e Figures — References to figures in the manual are represented by the capital letter F 
followed immediately by another alphanumeric character (representing the section or 
appendix of the manual containing the figure). The second character is followed by a 
dash (-) and a number. 


Fx-yy 


° Other entries in the Index — References to other entries in the index preceded by the 
word ‘‘See” followed by the referenced entry. 
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Activation, SCI 2... cc ee 1.3 
Addressing Modes ..............-: 3.3, T3-1 
Applicable Operations for I/O 
RESOUICES «464.36 uwadisteae p Seales T5-4 
ASCII Character Codes ............... T6-1 
Assembly Language: 
Instruction: 
Alphabetical Order ............... T3-3 
POIMAl: ccscatsie don Seb wakes 3.2, F3-1 
Hexadecimal Order............... T3-2 
Operation Code............02 eee eee 3.4 
Bit Description: 
SYStOM FlaGS: 0i45suesseene le seok. T5-2 
SG Fla Sei ka jab teen dd arate ot T5-3 
Business System Terminal Keyboard 
AV OU dette Sitar wince Side eh ee eee FA-5 
Call Block Extensions: 
IPC Channel Utility ............... 5.3.2.3 
JO Operations .......... 00 ccc 5.3.2 
VOVUGHNY 255 Gi.wkd wee eee en 5.3.2.1 
Teer ere eer ee ee rer eee eae 5.3.2.2 
Master Read ............000 cee D:3:2:0 
PD ee spsta cae tera atnineeee bine Heege 5.3.2.4 
LOO DORE ice ee eae ae ESAS 5.3.2.4 
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OA 5.0 2752 aed agence Oar oe 5 
ISU VDT «th Sacas anes eee 8 ead 5. 
QAO BVT esac de el ete eaten fice gpa iat 5 
Call Block Variant, I/O Operations...... 
Call Blocks,SVC ..... cee eee 
Call,Supervisor ..............00. SeeS 
Codes: 
ASCII Character ..............0005. T 
JOD SLAG ss Se tics $a Rarearee ee eas T7- 
SVC Operation ......... 0. cece ees 5 
Task State ........... ards a5 Ge ee T7- 
Command Entry Keys, VDT Mode ..... .12 
Command Interpreter, System...... See SCI 
Command Sequences: 
Copying aCrash File............... 1.6 
Copying aProgram File............. 1.6. 
Directory Modifications ............ 1.6. 
1 


Enabling Devices for the Spooler. . 6. 
PTC) RV ane fe cid Sls ed a a aes 1.6. 
Recovering Lost Output ............ 1.6 
RC I acre ay aah necate dete yan erent ee 1 
Showing aKlF .............20000 ee 1.6 
Spooler Recovery ...........0+006: 1.6. 

4- 

4- 


Commands: 
DODUQQE! eit:ts ces 2 dw ode ees 4. 
4. 


4 
LINK EGIL OP vce ones a sh: de ata een oma oa 3, 


Computer Status Register......... 3.7, F3-4 
Control Keys VDT Mode Command 

EXCCUNION: deicce peeudaeaneaeaeked ees T2-2 
Copying aCrash File................. 1.6.8 
Copying aProgram File .............. 1.6.7 
Crash: 

PUG! tel poe iok abs Seth aie atin des 1.6.8, 1.6.10 

Forced System...............000- 1.6.12 

SVSLOM «2 are aia ate ewe ae 1.6.9, 1.6.11, 1.6.12 
Currency Block, KIF................ 5.3.2.2 
Debugger Commands............. 4.4, 74-2 
Directory Modifications, Sequences....1.6.6 
DISDIAVS. TF sah 6. we ecw ee aah conn T2-3 
Dumping the Crash File, SCI 

PROCCOUICS 6.0. S.cnud tte a ee ee ees 1.6.10 
Enabling Devices forthe Spooler ......1.6.4 
Error Interrupt Status Bits ......... 3.6, F3-3 
File: 

ClraS)) seb scace seta bees Ske es 1.6.8, 1.6.10 

Key INGEXEd .5 ce: ik a wae Sees S See KIF 

PlOOKANN acu founda Gia awa Ace ot Meee ak 1.6.7 

Terminal Local................. See TLF 
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Flags: 
Bit Description: 


Ga 


NAY cap rohan hace o-ooe anaes maneeee 
Forced System Crash............... 1. 
Format: 

Assembly Language Instruction . .3.2, 
Object Cod@ igen. Saks barca dan 3.10, 
Function Keys, Text Editor ............. 
Functions, I/O Utility ................. 


Mm OAH 


Generic Keycap Names ............... 1. 
Appendix A, TA- 


— 
con — 
“NM G®aodns 


Hexadecimal Order, Assembly 


Language Instruction............... T3-2 
Initial Program Load............... See IPL 
Instruction, Assembly Language: 

Alphabetical ONGC Tous sharia ch a 2 at T3-3 

POMMAU hoe wes es cain Sate ld Gate 3.2, F3-1 

Hexadecimai Order ................ T3-2 
Interpreter, System Command...... See SCI 
Interrupt Status Bits, Error......... 3.6, F3-3 

Index 


Interrupt TrapS ..............005. 3.6, F3-2 
IPC Channel Utility, 1/O Operations Call 

Block Extensions ................ 5.3.2.3 
IPL, SCl Procedures .......... 1.6.10, 1.6.11 
I/O Operations: 

Call Block Extensions.............. 5.3.2 
IPC Channel Utility ............. 5.3.2.3 
WOSOTUNIY:: sede aati aati inbhateras 5.3.2.1 
FOUR agp cea od esapsy. ce ae pon aay aca el! 5.3.2.2 
Master Read .................. O20:2.0 
At cc ate dear ae cen bot c-aaead ata aaah erate 5.3.2.4 
LISA. 20ers are Eh oe wean 5.3.2.4 
OA WO ae ws Beets oe ae de sce. dete once 5.3.2.4 
O31 VDF 2 ncach2 Shes a eae oe eadaan 5:3:2:4 
QAQHE Ve dotinas dias 4: aie eae da ace eaed 5.3.2.4 

Call Block Variant ................. 5:3, 1 

Sub-Opcodes .......... 0.00 ce eee 5.3 

SYVSltEM PldGS sa c-Feha a ee a Eee cde T5-2 

WSer Flags... sa seein bt ee wee ene T5-3 

TY FIAGS & ccssc-scpeue ene aed Saka aber T5-5 

|/O Resources, Applicable 

Operations for.............0000 eee 15-4 

I/O Utility: 

FUNCTIONS: 4 cause Go ede rodee dae T5-6 

[/O Operations Call Block 
EXIGNSIONS 24 bice44 24S aee etre Dasa 
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Job State Codes.................000. T7-1 


Key Indexed File ................. See KIF 
Key SEQUENCES foie itn oat cab eek aaa TA-2 
Keyboard Layout: 
Business System Terminal.......... FA-5 
S2OKSR scx tedicetwoud ee kstew canes FA-6 
OW V Dal ee acaceve asked lode ioen ental aca caret FA-1 
OTN OE oe de tine ak ot Sees eet x a ek FA-2 
OS IVD Retcaneenbseed eee baweeaai FA-4 
QAO EV Wen: ocd se tice fy cravses He ete Blech ds FA-3 
Keycap Name Equivalents, 911 VDT ....TA-3 
Keycap Names, Generic............... 1.2, 
Appendix A, TA- 1 
Keys, Text Editor Function ............. 1.5 
KIF: 
Currency Block ...............005 5.3.2.2 
I/O Operations Call Block 
EX(GNISIONS © aicicecd hee oY ake Bac 5.3.2.2 
Link Editor Commands............ 4.3, T4-1 
Load, Initial Program .............. See IPL 
Log- -Off, SO) wsse des ake cate eau 1.4 
LOG2ON SGM gsccrteen f5 teres ew edeted 1.3 
Index 
\ 


Macro: 
COMPONENT 4 a4.0-ecxsausaw are ateens T3-7 
LANGUAGE: «2:3 x amoied bowen baat Sad Mea T3-6 
Main Menu, SCl.................. 1.3, F1-1 
Master Read, I/O Operations Call 
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